泛型

泛型指的是在定义函数、接口或类的时候，不预先指定具体的类型，而在使用的时候再指定类型的一种特性。

简单的例子

首先，我们来实现一个函数 createArray，它可以创建一个指定长度的数组，同时将每一项都填充一个默认值：

  1. function createArray(length: number, value: any): Array<any> {
  2.     let result = [];
  3.     for (let i = 0; i < length; i++) {
  4.         result[i] = value;
  5.     }
  6.     return result;
  7. }
  9. createArray(3, 'x'); // ['x', 'x', 'x']

这段代码编译不会报错，但是一个显而易见的缺陷是，它并没有准确的定义返回值的类型：

Array<any> 允许数组的每一项都为任意类型。但是我们预期的是，数组中每一项都应该是输入的 value 的类型。

这时候，泛型就派上用场了：

  1. function createArray<T>(length: number, value: T): Array<T> {
  2.     let result: T[] = [];
  3.     for (let i = 0; i < length; i++) {
  4.         result[i] = value;
  5.     }
  6.     return result;
  7. }
  9. createArray<string>(3, 'x'); // ['x', 'x', 'x']

多个类型参数

定义泛型的时候，可以一次定义多个类型参数：

  1. function swap<T, U>(tuple: [T, U]): [U, T] {
  2.     return [tuple[1], tuple[0]];
  3. }
  5. swap([7, 'seven']); // ['seven', 7]

泛型约束

在函数内部使用泛型变量的时候，由于事先不知道它是哪种类型，所以不能随意的操作它的属性或方法：

  1. function loggingIdentity<T>(arg: T): T {
  2.     console.log(arg.length); //类型“T”上不存在属性“length”。
  3.     return arg;
  4. }
  6. // index.ts(2,19): error TS2339: Property 'length' does not exist on type 'T'.

例中，泛型 T 不一定包含属性 length，所以编译的时候报错了。

这时，我们可以对泛型进行约束，只允许这个函数传入那些包含 length 属性的变量。这就是泛型约束：

  1. interface Lengthwise {
  2.     length: number;
  3. }
  5. function loggingIdentity<T extends Lengthwise>(arg: T): T {
  6.     console.log(arg.length);
  7.     return arg;
  8. }

上例中，我们使用了 extends 约束了泛型 T 必须符合接口 Lengthwise 的形状，也就是必须包含 length 属性。

此时如果调用 loggingIdentity 的时候，传入的 arg 不包含 length，那么在编译阶段就会报错了：

  1. interface Lengthwise {
  2.     length: number;
  3. }
  5. function loggingIdentity<T extends Lengthwise>(arg: T): T {
  6.     console.log(arg.length);
  7.     return arg;
  8. }
  10. loggingIdentity(7);
  12. // index.ts(10,17): error TS2345: Argument of type '7' is not assignable to parameter of type 'Lengthwise'.

多个类型参数之间也可以互相约束：

  1. function copyFields<T extends U, U>(target: T, source: U): T {
  2.     for (let id in source) {
  3.         target[id] = (<T>source)[id];
  4.     }
  5.     return target;
  6. }
  8. let x = { a: 1, c: 3, d: 4 };
  10. copyFields(x, { b: 10, d: 20 });
  12. // 类型“{ a: number; c: number; d: number; }”的参数不能赋给类型“{ b: number; d: number; }”的参数。
  13. //   类型 "{ a: number; c: number; d: number; }" 中缺少属性 "b"，但类型 "{ b: number; d: number; }" 中需要该属性。

上例中，我们使用了两个类型参数，其中要求 T 继承 U，这样就保证了 U 上不会出现 T 中不存在的字段。

泛型接口

之前学习过，可以使用接口的方式来定义一个函数想要符合的形状

  1. interface SearchFunc {
  2.   (source: string, subString: string): boolean;
  3. }
  5. let mySearch: SearchFunc;
  6. mySearch = function(source: string, subString: string) {
  7.     return source.search(subString) !== -1;
  8. }

当然也可以使用含有泛型的接口来定义函数的形状：

  1. interface CreateArrayFunc {
  2.     <T>(length: number, value: T): Array<T>;
  3. }
  5. let createArray: CreateArrayFunc;
  6. createArray = function<T>(length: number, value: T): Array<T> {
  7.     let result: T[] = [];
  8.     for (let i = 0; i < length; i++) {
  9.         result[i] = value;
  10.     }
  11.     return result;
  12. }
  14. createArray(3, 'x'); // ['x', 'x', 'x']

进一步，我们可以把泛型参数提前到接口名上：

  1. interface CreateArrayFunc<T> {
  2.     (length: number, value: T): Array<T>;
  3. }
  5. let createArray: CreateArrayFunc<any>;
  6. createArray = function<T>(length: number, value: T): Array<T> {
  7.     let result: T[] = [];
  8.     for (let i = 0; i < length; i++) {
  9.         result[i] = value;
  10.     }
  11.     return result;
  12. }
  14. createArray(3, 'x'); // ['x', 'x', 'x']

注意，此时在使用泛型接口的时候，需要定义泛型的类型。

泛型类

与泛型接口类似，泛型也可以用于类的类型定义中：

  1. class GenericNumber<T> {
  2.     zeroValue: T;
  3.     add: (x: T, y: T) => T;
  4. }
  6. let myGenericNumber = new GenericNumber<number>();
  7. myGenericNumber.zeroValue = 0;
  8. myGenericNumber.add = function(x, y) { return x + y; };

泛型参数的默认类型

在 TypeScript 2.3 以后，我们可以为泛型中的类型参数指定默认类型。当使用泛型时没有在代码中直接指定类型参数，从实际值参数中也无法推测出时，这个默认类型就会起作用。

  1. function createArray<T = string>(length: number, value: T): Array<T> {
  2.     let result: T[] = [];
  3.     for (let i = 0; i < length; i++) {
  4.         result[i] = value;
  5.     }
  6.     return result;
  7. }

声明合并

如果定义了两个相同名字的函数、接口或类，那么它们会合并成一个类型

函数的合并

我们可以使用重载定义多个函数类型：

  1. function reverse(x: number): number;
  2. function reverse(x: string): string;
  3. function reverse(x: number | string): number | string {
  4.     if (typeof x === 'number') {
  5.         return Number(x.toString().split('').reverse().join(''));
  6.     } else if (typeof x === 'string') {
  7.         return x.split('').reverse().join('');
  8.     }
  9. }

接口的合并

接口中的属性在合并时会简单的合并到一个接口中：

  1. interface Alarm {
  2.     price: number;
  3. }
  4. interface Alarm {
  5.     weight: number;
  6. }

相当于：

  1. interface Alarm {
  2.     price: number;
  3.     weight: number;
  4. }

注意，合并的属性的类型必须是唯一的：

  1. interface Alarm {
  2.     price: number;
  3. }
  4. interface Alarm {
  5.     price: number;  // 虽然重复了，但是类型都是 `number`，所以不会报错
  6.     weight: number;
  7. }
  8. interface Alarm {
  9.     price: number;
  10. }
  11. interface Alarm {
  12.     price: string;  // 类型不一致，会报错
  13.     weight: number;
  14. }
  16. // index.ts(5,3): error TS2403: Subsequent variable declarations must have the same type.  Variable 'price' must be of type 'number', but here has type 'string'.

接口中方法的合并，与函数的合并一样：

  1. interface Alarm {
  2.     price: number;
  3.     alert(s: string): string;
  4. }
  5. interface Alarm {
  6.     weight: number;
  7.     alert(s: string, n: number): string;
  8. }

相当于：

  1. interface Alarm {
  2.     price: number;
  3.     weight: number;
  4.     alert(s: string): string;
  5.     alert(s: string, n: number): string;
  6. }

类的合并

类的合并与接口的合并规则一致。