Awaited<Type>
Awaited<Type>
用来取出 Promise 的返回值类型,适合用在描述then()
方法和 await 命令的参数类型。
// string
type A = Awaited<Promise<string>>;
上面示例中,Awaited<Type>
会返回 Promise 的返回值类型(string)。
它也可以返回多重 Promise 的返回值类型。
// number
type B = Awaited<Promise<Promise<number>>>;
如果它的类型参数不是 Promise 类型,那么就会原样返回。
// number | boolean
type C = Awaited<boolean | Promise<number>>;
上面示例中,类型参数是一个联合类型,其中的boolean
会原样返回,所以最终返回的是number|boolean
。
Awaited<Type>
的实现如下。
type Awaited<T> =
T extends null | undefined ? T :
T extends object & {
then(
onfulfilled: infer F,
...args: infer _
): any;
} ? F extends (
value: infer V,
...args: infer _
) => any ? Awaited<...> : never:
T;
ConstructorParameters<Type>
ConstructorParameters<Type>
提取构造方法Type
的参数类型,组成一个元组类型返回。
type T1 = ConstructorParameters<
new (x: string, y: number) => object
>; // [x: string, y: number]
type T2 = ConstructorParameters<
new (x?: string) => object
>; // [x?: string | undefined]
它可以返回一些内置构造方法的参数类型。
type T1 = ConstructorParameters<
ErrorConstructor
>; // [message?: string]
type T2 = ConstructorParameters<
FunctionConstructor
>; // string[]
type T3 = ConstructorParameters<
RegExpConstructor
>; // [pattern:string|RegExp, flags?:string]
如果参数类型不是构造方法,就会报错。
type T1 = ConstructorParameters<string>; // 报错
type T2 = ConstructorParameters<Function>; // 报错
any
类型和never
类型是两个特殊值,分别返回unknown[]
和never
。
type T1 = ConstructorParameters<any>; // unknown[]
type T2 = ConstructorParameters<never>; // never
ConstructorParameters<Type>
的实现如下。
type ConstructorParameters<
T extends abstract new (...args: any) => any
> = T extends abstract new (...args: infer P)
=> any ? P : never
Exclude<UnionType, ExcludedMembers>
Exclude<UnionType, ExcludedMembers>
用来从联合类型UnionType
里面,删除某些类型ExcludedMembers
,组成一个新的类型返回。
type T1 = Exclude<'a'|'b'|'c', 'a'>; // 'b'|'c'
type T2 = Exclude<'a'|'b'|'c', 'a'|'b'>; // 'c'
type T3 = Exclude<string|(() => void), Function>; // string
type T4 = Exclude<string | string[], any[]>; // string
type T5 = Exclude<(() => void) | null, Function>; // null
type T6 = Exclude<200 | 400, 200 | 201>; // 400
type T7 = Exclude<number, boolean>; // number
Exclude<UnionType, ExcludedMembers>
的实现如下。
type Exclude<T, U> = T extends U ? never : T;