如何为基于原型的ES5类在TypeScript中添加类型定义？

针对你提供的ES5旧式类代码，无需改为ES6类语法，以下是添加TypeScript类型定义的推荐方案：

步骤1：定义实例接口 #

先声明实例的所有属性和方法（包括实例自身和原型上的成员）：

interface MyClassInstance {
  arg_prop_1: number;
  arg_prop_2: () => number;
  proto_prop: () => boolean;
}

步骤2：为构造函数指定类型 #

通过this参数标注构造函数内部的上下文类型，同时将构造函数断言为对应的构造器类型：

interface MyClassConstructor {
  new(arg1: number): MyClassInstance;
}

// 为构造函数的this指定类型，并断言构造器符合定义的接口
const MyClass = function(this: MyClassInstance, arg1: number) {
  this.arg_prop_1 = arg1;
  this.arg_prop_2 = function() { return this.arg_prop_1; }
} as MyClassConstructor;

步骤3：为原型方法添加类型 #

给原型上的方法也标注this参数，确保类型检查生效：

MyClass.prototype.proto_prop = function(this: MyClassInstance): boolean {
  return this.arg_prop_2() === 42;
}

验证使用 #

此时创建实例并调用方法会获得完整的类型支持：

const obj = new MyClass(42);
console.assert(obj.proto_prop()); // 类型检查完全通过

原有方案失效原因 #

你之前只定义了实例接口和构造器接口，但没有将MyClass函数与构造器接口关联起来。TypeScript无法自动推断这个普通函数是符合构造器签名的类型，因此会抛出“缺少构造签名”的错误。通过as MyClassConstructor断言，或者直接给构造函数添加this参数注解，才能让TS识别这是一个可被new调用的构造函数。

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