On this page

TypeScript 泛型

泛型允许创建“类型变量”,可用于创建不需要明确定义其所使用的类型的类、函数和类型别名。 泛型使得编写可重用代码变得更容易。


功能

具有函数的泛型有助于制定更通用的方法,以更准确地表示所使用和返回的类型。

例子

function createPair<S, T>(v1: S, v2: T): [S, T] {
  return [v1, v2];
}
console.log(createPair<string, number>('hello', 42)); // ['hello', 42]

TypeScript 还可以从函数参数推断出泛型参数的类型。


课程

泛型可用于创建通用类,例如Map。

例子

class NamedValue<T> {
  private _value: T | undefined;

  constructor(private name: string) {}

  public setValue(value: T) {
    this._value = value;
  }

  public getValue(): T | undefined {
    return this._value;
  }

  public toString(): string {
    return `${this.name}: ${this._value}`;
  }
}

let value = new NamedValue<number>('myNumber');
value.setValue(10);
console.log(value.toString());

如果在构造函数参数中使用泛型参数,TypeScript 还可以推断其类型。


类型别名

类型别名中的泛型允许创建更可重用的类型。

例子


type Wrapped<T> = { value: T };

const wrappedValue: Wrapped<number> = { value: 10 }

这也适用于具有以下语法的接口:interface Wrapped<T> {


默认值

可以为泛型分配默认值,如果没有指定或推断其他值,则应用该默认值。

例子

class NamedValue<T = string> {
  private _value: T | undefined;

  constructor(private name: string) {}

  public setValue(value: T) {
    this._value = value;
  }

  public getValue(): T | undefined {
    return this._value;
  }

  public toString(): string {
    return `${this.name}: ${this._value}`;
  }
}

let value = new NamedValue('myNumber');
value.setValue('myValue');
console.log(value.toString());

扩展

可以向泛型添加约束来限制允许的内容。约束使得在使用泛型时可以依赖更具体的类型。

例子

function createLoggedPair<S extends string | number, T extends string | number>(v1: S, v2: T): [S, T] {
  console.log(`creating pair: v1='${v1}', v2='${v2}'`);
  return [v1, v2];
}

这可以与默认值结合。