TypeScript中类型安全Wrapper类的实现难题

我要封装第三方的Base类，给它所有方法加日志和try/catch异常处理，同时让用户能像直接用Base一样用Wrapper（完全不用感知Wrapper存在）。目前通过动态遍历Base原型方法挂载到Wrapper，但遇到了类型警告，而且TypeScript不认可Wrapper有Base的方法，手动类型断言又不够优雅。另外Base类规模很大，有大量带可选参数、重载的方法，没法手动映射；直接继承Base会带来不需要的实例属性（比如示例里的name），不符合需求。

当前代码的类型问题：

• No index signature with a parameter of type 'string' was found on type 'Wrapper'
• No index signature with a parameter of type 'string' was found on type 'Base'
• 调用wrapper.first()时提示Property 'first' does not exist on type 'Wrapper'

可以用TypeScript接口合并+交叉类型让Wrapper获得Base的方法类型，同时保留自身属性，无需手动断言。具体步骤如下：

1. 提取Base的方法类型并合并到Wrapper接口 #

先筛选出Base里所有方法类型（排除实例属性），再通过接口合并让Wrapper拥有这些方法的类型定义：

// 提取Base的所有方法类型，排除非函数属性（比如name）
type BaseMethods = {
  [K in keyof Base as Base[K] extends Function ? K : never]: Base[K];
};

// 接口合并，让TypeScript认为Wrapper拥有Base的所有方法
interface Wrapper extends BaseMethods {}

2. 修正动态方法挂载的类型约束 #

遍历Base原型方法时，给methodName加上明确的类型，消除索引签名警告：

(Object.getOwnPropertyNames(Base.prototype) as Array<keyof BaseMethods>).forEach((methodName) => {
  if (methodName !== 'constructor') {
    Wrapper.prototype[methodName] = function (...args: Parameters<Base[typeof methodName]>) {
      for (const base of this.bases) {
        try {
          // 这里加日志逻辑
          console.log(`调用方法 ${String(methodName)}，参数：`, args);
          return base[methodName](...args);
        } catch (err) {
          // 异常处理逻辑
          console.error(`方法 ${String(methodName)} 执行失败：`, err);
          // 可选：继续执行下一个Base实例，或者返回默认值/抛出异常
        }
      }
    };
  }
});

完整可运行代码 #

class Base {
  name: string;

  constructor(name: string) {
    this.name = name;
  }

  first() {}
  second(val: number) {}
  third(vals: number[]) {}
  // 示例重载方法
  overloadMethod(a: string): string;
  overloadMethod(a: number): number;
  overloadMethod(a: string | number): string | number {
    return a;
  }
}

// 提取Base的方法类型（排除非函数属性）
type BaseMethods = {
  [K in keyof Base as Base[K] extends Function ? K : never]: Base[K];
};

// 接口合并，让Wrapper拥有Base的方法类型
interface Wrapper extends BaseMethods {}

class Wrapper {
  bases: Base[] = [];

  constructor(names: string[]) {
    for (const name of names) {
      this.bases.push(new Base(name));
    }
  }
}

// 动态挂载方法并添加类型约束
(Object.getOwnPropertyNames(Base.prototype) as Array<keyof BaseMethods>).forEach((methodName) => {
  if (methodName !== 'constructor') {
    Wrapper.prototype[methodName] = function (...args: Parameters<Base[typeof methodName]>) {
      for (const base of this.bases) {
        try {
          console.log(`在Base实例 ${base.name} 上执行 ${String(methodName)}`);
          return base[methodName](...args);
        } catch (err) {
          console.error(`Base实例 ${base.name} 的 ${String(methodName)} 方法出错：`, err);
          // 根据需求决定是否继续执行下一个实例
        }
      }
    };
  }
});

// 使用示例，TypeScript会正确识别所有Base方法
const wrapper = new Wrapper(['a', 'b', 'c']);
wrapper.first(); // 类型正确
wrapper.second(123); // 类型正确
wrapper.third([1,2,3]); // 类型正确
const strResult = wrapper.overloadMethod('test'); // strResult类型为string
const numResult = wrapper.overloadMethod(456); // numResult类型为number

关键细节 #

• 接口合并：通过interface Wrapper extends BaseMethods，让TypeScript自动识别Wrapper拥有Base的所有方法，解决了方法不存在的类型报错。
• 类型筛选：BaseMethods只保留Base中的函数属性，避免了直接继承Base带来的冗余实例属性（比如name）。
• 重载兼容：直接复用Base的方法类型，所以Base中的重载方法在Wrapper上能保留完整的类型推断。
• 消除索引警告：把Object.getOwnPropertyNames的结果断言为Array<keyof BaseMethods>，明确methodName是Base方法的合法键，解决了索引签名的类型警告。

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