JavaScript / TypeScript / 系统课时

infer 类型推断

infer 类型推断

infer 用来在条件类型的匹配过程中“拆出”内部类型。本节用函数返回值、数组元素和 Promise 结果三个常见场景说明它的写法,并通过一个可编译示例验证提取出的类型能继续参与后续约束。

学习目标

  • 理解 infer 在条件类型中的匹配位置和作用域
  • 能从函数、数组与 Promise 中提取内部类型
  • 知道联合类型分发与匹配失败时的边界

infer 的核心规则

infer 不能单独创建类型变量,它只能出现在条件类型 T extends Pattern ? X : Y 的匹配模式中。可以把它理解为“如果 T 能匹配这个结构,就把结构中的某一部分命名出来”。

例如 T extends Promise<infer U> ? U : T 会尝试把 T 当作 Promise<...> 匹配。匹配成功时,U 就是 Promise 包裹的类型;失败时走假分支。这个 U 只在条件类型的匹配结果中有意义,不是普通泛型参数。

一个示例提取三类内部类型

下面定义三个工具类型,并让提取结果真正参与变量检查。代码不依赖第三方库,保存为 infer-demo.ts 即可编译运行。

ts
type ReturnOf<T> =
  T extends (...args: never[]) => infer R ? R : never;

type ElementOf<T> =
  T extends readonly (infer U)[] ? U : never;

type UnwrapPromise<T> =
  T extends Promise<infer U> ? U : T;

type User = {
  id: number;
  name: string;
};

function loadUser(id: number): Promise<User> {
  return Promise.resolve({ id, name: "Ada" });
}

// 先提取函数返回值 Promise<User>,再提取 Promise 内部的 User。
type LoadedUser = UnwrapPromise<ReturnOf<typeof loadUser>>;
const user: LoadedUser = { id: 1, name: "Ada" };

const tags = ["ts", "types"] as const;
type Tag = ElementOf<typeof tags>;
const activeTag: Tag = "types";

console.log(user.name);
console.log(activeTag);

预期输出(使用 npx tsc --strict --target ES2020 --module commonjs infer-demo.ts && node infer-demo.js 编译并运行):

text
Ada
types

如果把 activeTag 改成 "javascript",编译器会拒绝赋值,因为 ElementOf<typeof tags> 提取到的是字面量联合类型 "ts" | "types",而不是宽泛的 string。

匹配失败与联合类型

条件类型匹配失败时会进入假分支,因此工具类型要提前决定“失败意味着什么”。像 ReturnOf<T> 这类只接受函数的工具通常返回 never;而 UnwrapPromise<T> 更适合在非 Promise 输入时保留原类型。

当裸类型参数 T 是联合类型时,条件类型通常会逐个成员分发。于是 UnwrapPromise<Promise<number> | string> 的结果是 number | string。如果业务上不希望分发,需要把条件两侧包进元组,例如 [T] extends [Promise<infer U>] ? U : T。

什么时候适合使用 infer

infer 最适合编写“从已有类型结构中提取信息”的工具类型,例如函数返回值、函数参数、数组元素、Promise 结果或某个泛型容器的内部类型。若目标类型已经可以直接写出,额外套一层条件类型只会增加阅读成本。

实际使用时先写清楚要匹配的外层结构,再决定匹配失败后的结果。这样得到的工具类型既能复用,也更容易在编辑器提示和编译错误中定位问题。

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

目录与阅读设置

阅读设置

17

记录一个想法

infer 类型推断

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

登录哪都通