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。临时类型变量只在条件类型的真分支中可用,不能在类型外部直接引用。

一次提取四类内部类型

下面的完整示例定义四个工具类型,并用真实变量验证推断结果。类型别名只参与编译检查,运行时输出来自已通过类型检查的值。

ts
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);

预期输出

text
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 的内部类型都可以通过结构匹配提取
  • 联合类型会分发,重载函数通常按最后一个签名推断

下一课预告

下一课将学习映射类型,遍历对象键名并批量增加、移除或重映射属性修饰符。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 infer 提取类型

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通