如何为TypeScript元组添加自定义方法并支持数组解构？

你遇到的问题核心是原SuperTuple类型仅定义了元组结构，没有包含自定义方法mapIndex，导致Object.assign返回的混合对象无法通过类型校验。下面是具体的解决思路和完整实现：

1. 重新定义SuperTuple类型 #

使用交叉类型，让它同时具备元组[number, string]的结构和mapIndex方法：

type SuperTuple = [number, string] & {
  // mapIndex接收一个处理数字的函数，返回新的SuperTuple
  mapIndex: (fn: (num: number) => number) => SuperTuple;
};

2. 修正supTup函数的类型断言 #

Object.assign返回的对象同时是元组和带有方法的对象，TypeScript无法自动推断其类型，需要手动用as SuperTuple做类型断言：

function supTup(num: number, str: string): SuperTuple {
  const tup: [number, string] = [num, str];
  return Object.assign(tup, {
    mapIndex: (fn: (x: number) => number) => supTup(fn(num), str)
  }) as SuperTuple;
}

3. 保持torgle函数的逻辑不变 #

function torgle(value: string): SuperTuple {
  return supTup(value.length, value);
}

验证期望用法 #

现在两种需求都能满足：

// 正常解构
const [index1, label1] = torgle('pizza');
console.log(index1, label1); // 5 'pizza'

// 调用mapIndex后解构
const [index2, label2] = torgle('pasta').mapIndex(i => i * 2);
console.log(index2, label2); // 10 'pasta'

// 链式调用mapIndex也支持
const [index3, label3] = torgle('test').mapIndex(i => i + 1).mapIndex(i => i * 3);
console.log(index3, label3); // 15 'test'

为什么之前的代码报错？ #

原SuperTuple仅描述了[number, string]的元组结构，但Object.assign返回的对象额外包含了mapIndex方法，TypeScript认为这个对象不符合原SuperTuple的类型定义，因此抛出错误。通过交叉类型扩展SuperTuple的定义，并添加类型断言，就能让编译器识别这个混合对象的合法性。

内容的提问来源于stack exchange，提问作者Sasgorilla