TypeScript 中如何表示当前类的类型

1,221 阅读2分钟

在 TypeScript 中,我们有时需要在类的内部或外部引用“当前类的类型”。这在实现设计模式(如工厂模式、单例模式)、继承或泛型类时非常有用。本文将总结如何在不同上下文中表示当前类的类型。


一、在类的静态方法或属性中引用当前类的类型

使用 typeof 表达当前类的构造函数类型:

class MyClass {
  static create(): MyClass {
    return new this(); // this 指的是当前构造函数
  }
}

但如果你要准确标注当前类的类型,可以这样写:

class MyClass {
  static factory(cls: typeof MyClass): MyClass {
    return new cls();
  }
}

示例:支持继承的工厂方法

class Base {
  static create<T extends typeof Base>(this: T): InstanceType<T> {
    return new this();
  }
}

class Sub extends Base {}

const instance = Sub.create(); // 类型是 Sub

二、在类的内部方法中引用当前实例的类型

1. 使用 this 类型

class Builder {
  setName(name: string): this {
    // 可以继续调用其他方法
    return this;
  }
}

2. 示例:链式 API

class BaseBuilder {
  setName(name: string): this {
    return this;
  }
}

class AdvancedBuilder extends BaseBuilder {
  setAge(age: number): this {
    return this;
  }
}

const builder = new AdvancedBuilder()
  .setName("Alice")
  .setAge(30); // builder 类型是 AdvancedBuilder

三、获取类本身的类型 vs 实例类型

表达式含义
typeof MyClass表示类的构造函数类型
MyClass表示类实例的类型
InstanceType<typeof MyClass>从构造函数类型提取实例类型

示例:

class Person {
  name = "John";
}

type PersonConstructor = typeof Person; // 构造函数类型
type PersonInstance = InstanceType<typeof Person>; // 实例类型

四、限制参数为“当前类类型”的技巧

class Animal {
  cloneFrom(other: this): void {
    Object.assign(this, other);
  }
}

五、结合泛型的“当前类类型”

class FluentBase<Self extends FluentBase<Self>> {
  doSomething(): Self {
    return this as Self;
  }
}

class FluentChild extends FluentBase<FluentChild> {
  extra(): FluentChild {
    return this;
  }
}

const result = new FluentChild().doSomething().extra(); // 类型安全!

六、总结

目的用法
表示当前类的构造函数类型typeof ClassName
表示当前类的实例类型ClassNameInstanceType<typeof ClassName>
在类内部方法中表示实例类型this
在静态方法中引用当前构造函数this: typeof ClassNamethis: T
用泛型表示当前类<Self extends Base<Self>>

如果你正在实现链式 API、工厂方法或继承层次较复杂的类库,这些技巧都可以大大增强类型的表达力和安全性。