TypeScript-泛型

泛型是什么

泛型是TypeScript的核心特性之一，它允许我们在定义函数、接口或类时不具体指定类型，而是在使用时再指定类型。泛型可以让我们编写更加通用、灵活的代码，提高代码的重用性和可维护性。

泛型函数

我们可以使用 <T> 来定义泛型函数，写在函数名后面，其中 T 是一个类型变量，表示函数的参数和返回值类型。在使用泛型函数时，我们可以指定具体的类型，也可以让TypeScript自动推断类型。

function identity<T>(arg: T): T {
  return arg;
}

const output1 = identity<string>("myString");
const output2 = identity<number>(42);
// or 自动推断
const output3 = identity("myString");
const output4 = identity(42);

同样可以定义多个泛型，使用逗号隔开。需要注意的是类型参数的名字，可以随便取。不过我们一般使用 T 、U 、V等大写字母来实现。

function identity<T, U>(arg: T, arg2: U): T {
  console.log(arg2);
  return arg;
}

const output1 = identity<string[], number[]>("myString", 42);

对于变量形式定义的函数，需要下面写法。

let my:<T>(arg: T) => T = fun;
// or 
let my: {<T>(arg: T) : T} = fun;

泛型接口

同样的，接口 interface 也可以使用泛型写法。

interface Person<T, U> {
  name: T;
  age: U;
}

const person1: Person<string, number> = { name: "John", age: 30 };
const person2: Person<number, string> = { name: 42, age: "30" };

泛型接口继承。

interface Person<T> {
  name: T;
}

interface Employee<U> extends Person<U> {
  id: U;
}

const employee: Employee<string> = { name: "John", id: '42' };
const employee2: Employee<number> = { name: 42, id: 123 };

泛型类

泛型类与泛型函数类似，类型参数写在类名后。

class GenericNumber<T> {
  zeroValue: T;
  add: (x: T, y: T) => T;
}

let myGenericNumber = new GenericNumber<number>();
myGenericNumber.zeroValue = 0;
myGenericNumber.add = function (x, y) { return x + y; };

泛型类继承，和泛型接口相似。

class Person<T> {
  name: T;
}

class Employee<U> extends Person<U> {
  id: U;
}

const employee: Employee<string> = { name: "John", id: '42' };
const employee2: Employee<number> = { name: 42, id: 123 };

泛型类的表达式写法。

const GenericNumber = class<T> {
  zeroValue: T;
  add: (x: T, y: T) => T;
};

let myGenericNumber = new GenericNumber<number>();
myGenericNumber.zeroValue = 0;
myGenericNumber.add = function (x, y) { return x + y; };

关于泛型类，需要注意的是，泛型类描述的是类的实例，不包括定义在类本身的静态属性和静态方法。

泛型类型别名

使用 type 命令定义的类型别名，也可以使用泛型。

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

type Tree<T> = {
  value: T;
  left: Tree<T> | null;
  right: Tree<T> | null;
};

type Nullable<T> = T | null|undefined;

如上，Container 是一个泛型类型别名，Tree 是一个嵌套的泛型类型别名，Nullable 是一个联合类型别名。

泛型默认值

可以为泛型类型指定默认值，当使用泛型类型时，如果没有指定类型参数，就会使用默认值。

function createArray<T = string>(length: number, value: T): Array<T> {
  let result: T[] = [];
  for (let i = 0; i < length; i++) {
    result[i] = value;
  }
  return result;
}

createArray(3, "x"); // ['x', 'x', 'x']

不过，TypeScript 会从实现参数中推断出类型参数，从而覆盖掉原本默认值。

function createArray<T = string>(length: number, value: T): Array<T> {
  let result: T[] = [];
  for (let i = 0; i < length; i++) {
    result[i] = value;
  }
  return result;
}

createArray(3,3); // [3, 3, 3]

上面实例中，value 参数的类型被推断为 number，所以默认值 string 被覆盖了。

泛型参数的默认值，我们可以用在类中。

class GenericNumber<T = number> {
  zeroValue: T;
  add: (x: T, y: T) => T;
}

let myGenericNumber = new GenericNumber(); // 默认是 number 类型

myGenericNumber.zeroValue = 0;
myGenericNumber.add = function (x, y) { return x + y; };


myGenericNumber.zeroValue = '0'; // 报错 不能将类型“string”分配给类型“number”

需要注意，泛型参数如果有默认值，那么这个参数在函数调用时是可选的。如果有多个参数，可选参数需要在必选参数之后。

泛型数组

泛型数组，就是泛型类型数组，数组中的元素类型是泛型类型。

let list: Array<number> = [1, 2, 3];

let list2: Array<string> = ['1', '2', '3'];

let list3:number[] = [1, 2, 3];

let list4:string[] = ['1', '2', '3'];

上面示例中，Array<number> 其实就是一个泛型，类型参数的值是 number。

interface Array<Type> {
  length: number;

  pop(): Type | undefined;

  push(...items: Type[]): number;

  // ...
}

泛型参数的约束

泛型参数可以约束，约束泛型参数的类型，比如，泛型参数必须是某个类的实例，或者泛型参数必须实现某个接口。

interface Lengthwise {
  length: number;
}

function loggingIdentity<T extends Lengthwise>(arg: T): T {
  console.log(arg.length); 
  return arg;
}


loggingIdentity({length: 10, value: 3});
loggingIdentity(3);  // Error 类型“number”的参数不能赋给类型“Lengthwise”的参数。

如上，泛型参数 T 被约束为 Lengthwise 接口，所以 arg 参数必须实现 Lengthwise 接口。

类型参数可以同时设置约束调节和默认值，但是默认值需要满足约束的条件。

type Fn<A extends string, B extends string = "world"> = [A, B];

type Result = Fn<"hello">; // ["hello", "world"]

除此之外，如果有多个类型参数，一个类型参数的约束条件可以引用其他参数。

<T, U extends T>
// 或者
<T extends U, U>

泛型使用注意点

1. 尽量少用泛型。虽然泛型比较灵活，但是会增加代码复杂性，可读性变差。
2. 类型参数越少越好。类型参数越多，代码可读性越差。
3. 类型参数至少出现两次，如果只有一次，则说明该参数不是必要的。
4. 泛型可以嵌套，但是会增加代码复杂性，可读性变差。

类型工具范型

TypeScript 提供了一些内置的类型工具，这些工具可以帮助我们在类型层面上进行操作。这些工具通常以 T 作为参数，并返回一个新的类型。

Awaited<T>

Awaited<T> 是一个内置的类型工具，用于获取 Promise 对象的解析类型。返回的类型是 Promise 对象中 then 方法的参数类型。

async function fetchData(): Promise<string> {
    return "data";
}

type DataType = Awaited<ReturnType<typeof fetchData>>; // DataType 的类型为 string

async function example() {
    const data: DataType = await fetchData(); // data 的类型为 string
    console.log(data);
}

ConstructorParameters<T>

ConstructorParameters<T> 是一个内置的类型工具，用于获取构造函数的参数类型。返回的类型是一个元组，元组中的元素类型是构造函数的参数类型。

// 定义一个类 Person，带有构造函数
class Person {
    constructor(public name: string, public age: number) {}
}

// 使用 ConstructorParameters 提取 Person 构造函数的参数类型
type PersonConstructorParams = ConstructorParameters<typeof Person>; // [string, number]

// PersonConstructorParams 被推断为 [string, number]
const params: PersonConstructorParams = ['Alice', 30];

Excluding<T, K>

Excluding<T, K> 是一个内置的类型工具，用于从类型 T 中排除类型 K。返回的类型是 T 中不包含 K 的类型。

// 定义一个接口 User
interface User {
    id: number;
    name: string;
    email: string;
}

// 使用 Omit 排除 User 接口中的 email 属性
type UserWithoutEmail = Omit<User, 'email'>;
// UserWithoutEmail 现在是 { id: number; name: string; }

Extract<T, K>

Extract<T, K> 是一个内置的类型工具，用于从类型 T 中提取类型 K。返回的类型是 T 中包含 K 的类型。

// 定义一个联合类型
type Fruit = 'apple' | 'banana' | 'orange' | 'grape';

// 定义一个类型，表示我们想要提取的水果
type Citrus = 'orange' | 'lemon';

// 使用 Extract 提取 Fruit 中的 Citrus 类型
type ExtractedFruits = Extract<Fruit, Citrus>;

// ExtractedFruits 现在是 'orange'
const citrusFruit: ExtractedFruits = 'orange'; // 正确

InstanceType<T>

InstanceType<T> 是一个内置的类型工具，用于获取构造函数类型的实例类型。返回的类型是构造函数的实例类型。

// 定义一个类 Person
class Person {
    constructor(public name: string, public age: number) {}
}

// 使用 InstanceType 提取 Person 类型的实例类型
type PersonInstance = InstanceType<typeof Person>;

// PersonInstance 现在是 Person
const person: PersonInstance = new Person('Alice', 30);

NonNullable<T>

NonNullable<T> 是一个内置的类型工具，用于从类型 T 中排除 null 和 undefined。返回的类型是 T 中不包含 null 和 undefined 的类型。

// 定义一个联合类型
type MaybeString = string | null | undefined;
// 使用 NonNullable 从 MaybeString 中排除 null 和 undefined
type NonNullableString = NonNullable<MaybeString>;
// NonNullableString 现在是 string
const nonNullableString: NonNullableString = 'Hello, world!';

Omit<T, K>

Omit<T, K> 是一个内置的类型工具，用于从类型 T 中排除属性 K。返回的类型是 T 中不包含 K 的类型。

// 定义一个接口 User
interface User {
    id: number;
    name: string;
    email: string;
}
// 使用 Omit 排除 User 接口中的 email 属性
type UserWithoutEmail = Omit<User, 'email'>;
// UserWithoutEmail 现在是 { id: number; name: string; }

OmitThisParameter<T>

OmitThisParameter<T> 是一个内置的类型工具，用于从类型 T 中排除 this 参数。返回的类型是 T 中不包含 this 参数的类型。

// 定义一个类
class Calculator {
    constructor(public value: number) {}

    // 定义一个方法，带有 this 参数
    add(this: Calculator, amount: number) {
        this.value += amount;
        return this.value;
    }
}

// 使用 OmitThisParameter 来创建一个不带 this 参数的函数类型
type AddFunction = OmitThisParameter<typeof Calculator.prototype.add>;

// 创建一个 Calculator 实例
const calculator = new Calculator(10);

// 创建一个不带 this 参数的函数
const add: AddFunction = calculator.add.bind(calculator);

// 使用不带 this 参数的函数
const result = add(5); // 结果是 15

console.log(result); // 输出: 15
console.log(calculator.value); // 输出: 15

Parameters<T>

Parameters<T> 是一个内置的类型工具，用于获取函数类型的参数类型。返回的类型是一个元组，元组中的每个元素对应函数参数的类型。

// 定义一个函数类型
type Func = (a: number, b: string) => void;

// 使用 Parameters 获取 Func 的参数类型
type FuncParameters = Parameters<Func>;
// FuncParameters 现在是 [number, string]

Partial<T>

Partial<T>，将类型 T 中的所有属性变为可选。

interface Person {
    name: string;
    age: number;
}

type PartialPerson = Partial<Person>;
// 相当于
type PartialPerson = {
    name?: string;
    age?: number;
};

Pick<T, K>

Pick<T, K>，从类型 T 中选择属性 K，返回一个新的类型。

interface Person {
    name: string;
    age: number;
    email: string;
}

type PersonName = Pick<Person, 'name'>;
// 相当于
type PersonName = {
    name: string;
};

Readonly<T>

Readonly<T>，将类型 T 中的所有属性变为只读。

interface Person {
    name: string;
    age: number;
}

type ReadonlyPerson = Readonly<Person>;
// 相当于
type ReadonlyPerson = {
    readonly name: string;
    readonly age: number;
};

Record<K, T>

Record<K, T>，创建一个对象类型，其属性键为类型 K，属性值为类型 T。

type StringArray = Record<string, string[]>;

const names: StringArray = {
    foo: ['Alice', 'Bob'],
    bar: ['Charlie', 'David'],
};

Required<T>

Required<T>，将类型 T 中的所有属性变为必选。

interface Person {
    name?: string;
    age?: number;
}

type RequiredPerson = Required<Person>;
// 相当于
type RequiredPerson = {
    name: string;
    age: number;
};

ReadonlyArray<T>

ReadonlyArray<T>，将数组类型 T 中的所有元素变为只读。

const names: ReadonlyArray<string> = ['Alice', 'Bob'];
names[0] = 'Charlie'; // Error: Assignment to readonly property

ReturnType<T>

ReturnType<T>，获取函数类型 T 的返回类型。

type Func = () => number;

type FuncReturnType = ReturnType<Func>;
// FuncReturnType 现在是 number

ThisParameterType<T>

ThisParameterType<T>，获取函数类型 T 的 this 参数类型。

function greet(this: { name: string }) {
    console.log(`Hello, ${this.name}!`);
}

type GreetThisType = ThisParameterType<typeof greet>;
// GreetThisType 现在是 { name: string }

thisType<T>

ThisType<Type> 不返回类型，只用来跟其他类型组成交叉类型，用来提示 TypeScript 其他类型里面的this的类型。

let obj: ThisType<{ x: number }> & { getX: () => number };

obj = {
  getX() {
    return this.x + this.y; // 报错
  },
};

如上，ThisType<{ x: number }> & { getX: () => number } 提示 obj 对象的 this 类型是 { x: number }，并且 obj 对象必须包含一个 getX 方法，该方法返回一个数字。

字符串范型

Uppercase<T>

Uppercase<T>，将字符串类型 T 中的所有字符变为大写。

type LowercaseString = 'hello';
type UppercaseString = Uppercase<LowercaseString>;
// UppercaseString 现在是 'HELLO'

Lowercase<T>

Lowercase<T>，将字符串类型 T 中的所有字符变为小写。

type UppercaseString = 'HELLO';
type LowercaseString = Lowercase<UppercaseString>;
// LowercaseString 现在是 'hello'

Capitalize<T>

Capitalize<T>，将字符串类型 T 中的第一个字符变为大写。

type LowercaseString = 'hello';
type CapitalizedString = Capitalize<LowercaseString>;
// CapitalizedString 现在是 'Hello'

Uncapitalize<T>

Uncapitalize<T>，将字符串类型 T 中的第一个字符变为小写。

type UppercaseString = 'HELLO';
type UncapitalizedString = Uncapitalize<UppercaseString>;
// UncapitalizedString 现在是 'hELLO'

贡献者: Yevin Yu

上一页TypeScript-类（Class）

下一页TypeScript-模块