JavaScript / TypeScript / 系统课时
使用 infer 提取类型
使用 infer 提取类型
infer 用于在条件类型匹配成功时临时声明一个待推断类型。它适合从函数、数组、元组或 Promise 等复合类型中拆出内部类型,让通用工具类型不必由调用者重复填写细节。
学习目标
- 理解
infer在条件类型中的位置和作用 - 提取函数返回值、参数、数组元素与 Promise 结果
- 识别匹配失败、联合类型和重载函数的边界
infer 的基本规则
infer 只能出现在条件类型 T extends Pattern ? TrueType : FalseType 的匹配模式中。TypeScript 会尝试让 T 符合模式,并把对应位置推断出的类型绑定给临时变量。
例如,T extends readonly (infer Item)[] ? Item : never 会在 T 是数组或只读数组时提取元素类型;不匹配时返回 never。临时类型变量只在条件类型的真分支中可用,不能在类型外部直接引用。
一次提取四类内部类型
下面的完整示例定义四个工具类型,并用真实变量验证推断结果。类型别名只参与编译检查,运行时输出来自已通过类型检查的值。
type FunctionReturn<T> =
T extends (...args: any[]) => infer Result ? Result : never;
type FunctionParameters<T> =
T extends (...args: infer Params) => any ? Params : never;
type ArrayElement<T> =
T extends readonly (infer Item)[] ? Item : never;
type PromiseValue<T> =
T extends Promise<infer Value> ? Value : T;
function createUser(id: number, name: string) {
return { id, name, active: true };
}
async function loadReady() {
return true;
}
type User = FunctionReturn<typeof createUser>;
type CreateUserArgs = FunctionParameters<typeof createUser>;
type Score = ArrayElement<readonly [21, 42, 63]>;
type Ready = PromiseValue<FunctionReturn<typeof loadReady>>;
const args: CreateUserArgs = [2, "Ada"];
const user: User = createUser(...args);
const score: Score = 42;
const ready: Ready = true;
console.log(user.name, user.id, score, ready);预期输出
Ada 2 42 true如果把 score 改为 50,编译器会报错,因为 Score 被推断为字面量联合类型 21 | 42 | 63,而不是宽泛的 number。
关键边界
条件类型遇到联合类型时通常会逐个成员分发。例如 ArrayElement<string[] | number[]> 的结果是 string | number。若不希望分发,可以把两侧包进元组:[T] extends [Pattern] ? ... : ...。
提取 Promise 结果时,简单写法只展开一层。需要递归处理多层 Promise 或兼容非 Promise 值时,实际项目可优先使用 TypeScript 内置的 Awaited<T>。
对于重载函数,基于函数类型提取参数或返回值时,通常以最后一个重载签名为准。因此工具类型适合读取公开签名,不适合替代对复杂重载行为的完整建模。
本课总结
infer在条件类型的匹配模式中声明临时类型变量- 函数、数组和 Promise 的内部类型都可以通过结构匹配提取
- 联合类型会分发,重载函数通常按最后一个签名推断
下一课预告
下一课将学习映射类型,遍历对象键名并批量增加、移除或重映射属性修饰符。