JavaScript / TypeScript / 系统课时

条件类型

条件类型

当一个结果类型需要根据输入类型是否满足某个约束来决定时,条件类型可以把这种分支直接写进类型系统。它的作用类似类型层面的条件表达式,常用于提取内部类型、过滤联合类型以及封装可复用的工具类型。

学习目标

  • 理解 T extends U ? X : Y 的判断语义
  • 使用 infer 从匹配到的类型结构中提取内部类型
  • 掌握条件类型对联合类型的分发行为及其关闭方式

条件类型如何判断

条件类型的基本形式是 T extends U ? X : Y。这里的 extends 判断的是类型可赋值关系:如果 T 可以赋值给 U,结果选择 X,否则选择 Y。它并不只表示类继承关系。

例如 type IsString<T> = T extends string ? true : false 中,IsString<"ok"> 得到 true,而 IsString<number> 得到 false。这种结果仍然只是类型,不会生成运行时分支代码。

用 infer 提取内部类型

当满足条件后还需要拿到类型结构中的某一部分,可以在条件位置使用 infer 声明一个待推断的类型变量。下面从带有 payload 字段的响应类型中提取真正的载荷类型。

ts
// 匹配 payload 结构,并把内部类型绑定为 P
type PayloadOf<T> =
  T extends { payload: infer P }
    ? P
    : never;

type UserResponse = {
  payload: { id: number; name: string };
};

type CountResponse = {
  payload: number;
};

const user: PayloadOf<UserResponse> = { id: 1, name: "Ada" };
const count: PayloadOf<CountResponse> = 3;

// 两个变量都已经被约束为各自 payload 的真实类型
console.log(`${user.name}:${count}`);

预期输出

text
Ada:3

如果传入的类型没有 payload,这里会得到 never。这是一种常见设计:条件不满足时让类型“不可产生有效值”,从而在编译阶段阻止错误使用。

联合类型为什么会分发

当条件左侧是裸类型参数时,条件类型会对联合类型的每个成员分别计算。比如 type ToArray<T> = T extends unknown ? T[] : never,那么 ToArray<string | number> 的结果是 string[] | number[],而不是 (string | number)[]。

如果希望把整个联合类型当成一个整体判断,可以把两侧包进元组:type ToArrayWhole<T> = [T] extends [unknown] ? T[] : never。此时 ToArrayWhole<string | number> 才会得到 (string | number)[]。

用条件类型过滤联合成员

分发特性与 never 组合后,可以自然地完成过滤。type NonNull<T> = T extends null | undefined ? never : T 会逐个检查联合成员,因此 NonNull<string | null | undefined> 最终只剩 string。

内置工具类型 Exclude<T, U>、Extract<T, U> 和 NonNullable<T> 都依赖类似思路。编写自己的条件类型时,先确认你需要的是“逐成员分发”还是“整体判断”;很多看似异常的联合类型结果,本质上都来自这一区别。

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

目录与阅读设置

阅读设置

17

记录一个想法

条件类型

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

登录哪都通