所有 TypeScript 中内置的泛型类型(Generic Utility Types)
1. Awaited<Type>
说明:获取 Promise 类型中 resolve 的值类型。
ts
type A = Awaited<Promise<number>>; // A: number
2. Partial<Type>
说明:将对象类型的所有属性变为可选。
ts
interface User { name: string; age: number; }
type PartialUser = Partial<User>; // { name?: string; age?: number; }
3. Required<Type>
说明:将对象类型的所有属性变为必选。
ts
interface User { name?: string; age?: number; }
type RequiredUser = Required<User>; // { name: string; age: number; }
4. Readonly<Type>
说明:将对象类型的所有属性变为只读。
ts
interface User { name: string; }
type ReadonlyUser = Readonly<User>; // { readonly name: string; }
5. Record<Keys, Type>
说明:创建一个对象类型,key集合由 Keys 指定,值的类型是 Type。
ts
type Scores = Record<'math' | 'english', number>; // { math: number; english: number; }
6. Pick<Type, Keys>
说明:从对象类型中选择一组属性,组成新的类型。
ts
interface User { name: string; age: number; sex: string; }
type NameAndAge = Pick<User, 'name' | 'age'>; // { name: string; age: number; }
7. Omit<Type, Keys>
说明:从对象类型中去除一组属性,剩下一组属性组成新类型。
ts
interface User { name: string; age: number; sex: string; }
type UserWithoutAge = Omit<User, 'age'>; // { name: string; sex: string; }
8. Exclude<UnionType, ExcludedMembers>
说明:从联合类型中排除一组类型,生成新的联合类型。
ts
type T = Exclude<'a' | 'b' | 'c', 'a'>; // 'b' | 'c'
9. Extract<Type, Union>
说明:从联合类型中提取出所有可以赋值给 Union 的成员。
ts
type T = Extract<'a' | 'b' | 'c', 'a' | 'f'>; // 'a'
10. NonNullable<Type>
说明:去除类型中的 null 和 undefined。
ts
type T = NonNullable<string | number | undefined>; // string | number
11. Parameters<Type>
说明:获取函数参数类型组成的元组类型。
ts
function foo(a: number, b: string): void {}
type T = Parameters<typeof foo>; // [number, string]
12. ConstructorParameters<Type>
说明:获取构造函数的参数类型组成的元组类型。
ts
class Person { constructor(age: number, name: string) {} }
type T = ConstructorParameters<typeof Person>; // [number, string]
13. ReturnType<Type>
说明:获取函数返回值的类型。
ts
function foo(): boolean { return true }
type T = ReturnType<typeof foo>; // boolean
14. InstanceType<Type>
说明:获取构造函数实例的类型。
ts
class Person {}
type T = InstanceType<typeof Person>; // Person
15. NoInfer<Type>
说明:阻止类型参数被自动推断,常用于类型约束和高级类型体操中。
ts
function foo<T, U = NoInfer<T>>(arg: T, value: U): [T, U] { return [arg, value]; }
16. ThisParameterType<Type>
说明:获取函数的 this 参数类型。
ts
function fn(this: Date, x: number) {}
type T = ThisParameterType<typeof fn>; // Date
17. OmitThisParameter<Type>
说明:返回删除 this 参数后的函数新类型。
ts
function fn(this: Date, x: number) { }
type T = OmitThisParameter<typeof fn>; // (x: number) => void
18. ThisType<Type>
说明:指定对象字面量中 this 的类型(只在对象字面量中有用)。
ts
type Obj = { x: number } & ThisType<{ y: string }>;
// obj.y 的类型将被推断为 string
Intrinsic String Manipulation Types
字符串内置操作类型
a. Uppercase<StringType>
说明:将字符串类型全转为大写。
ts
type Str = Uppercase<'abc'>; // "ABC"
b. Lowercase<StringType>
说明:将字符串类型全转为小写。
ts
type Str = Lowercase<'ABC'>; // "abc"
c. Capitalize<StringType>
说明:将字符串类型首字母大写。
ts
type Str = Capitalize<'hello'>; // "Hello"
d. Uncapitalize<StringType>
说明:将字符串类型首字母小写。
ts
type Str = Uncapitalize<'Hello'>; // "hello"