JavaScript / TypeScript / 系统课时

编写条件类型

编写条件类型

条件类型用于在类型系统中表达“满足某个约束就得到一种类型,否则得到另一种类型”。本课会通过可运行示例理解基本分支、infer 提取,以及联合类型为何会被逐项计算。

学习目标

  • 掌握 T extends U ? X : Y 的判断规则
  • 使用 infer 从数组等结构中提取内部类型
  • 区分分发式与非分发式条件类型

条件类型的基本规则

条件类型写成 T extends U ? X : Y。这里的 extends 判断的是类型 T 是否可赋给类型 U,不是运行时的布尔表达式,也不会生成 JavaScript 分支。

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

// 裸类型参数 T 遇到联合类型时,会对每个成员分别计算
type ToArray<T> = T extends unknown ? T[] : never;

// 用元组包住 T,可关闭分发并把联合整体参与判断
type ToArrayTogether<T> = [T] extends [unknown] ? T[] : never;

type Value = string | number;
type Distributed = ToArray<Value>;
type NonDistributed = ToArrayTogether<Value>;
type Item = ElementType<readonly ["ready", "done"]>;

const oneKind: Distributed = ["ready"];
const mixed: NonDistributed = ["ready", 200];
const item: Item = "ready";

console.log(Array.isArray(oneKind));
console.log(mixed.join(","));
console.log(item.toUpperCase());

预期输出

text
true
ready,200
READY

ElementType<T> 在 T 是只读或普通数组时,用 infer U 捕获元素类型;否则直接返回 T。因此 Item 被推断为字面量联合 "ready" | "done"。

理解联合类型的分发

当条件左侧是未包装的类型参数 T 时,ToArray<string | number> 会先拆成两个成员,再分别计算:

ts
type Result =
  | (string extends unknown ? string[] : never)
  | (number extends unknown ? number[] : never);

这是片段示例,用于展示编译器的等价计算过程,不会产生运行时输出。最终结果是 string[] | number[],所以它接受纯字符串数组或纯数字数组,但不接受同时包含两种元素的数组。

关闭分发的方式

把判断两侧都放进单元素元组后,[T] extends [U] 会把联合类型作为整体判断。于是 ToArrayTogether<string | number> 的结果是 (string | number)[],可以保存混合元素。

关闭分发不是性能优化,而是语义选择。需要“逐个处理联合成员”时使用裸 T;需要“整体判断联合”时使用 [T]。这一区别在过滤联合、包装返回值和提取成员时尤其重要。

条件类型的常用边界

never 可以理解为没有成员的联合。分发式条件类型接收 never 时,没有任何成员可计算,所以结果仍是 never。若希望把 never 当作一个整体检测,需要同样使用元组包装,例如 [T] extends [never] ? true : false。

any 可能同时影响真假两个分支,导致结果过宽。编写通用工具类型时,优先使用 unknown 作为安全的顶层约束,再通过条件类型逐步缩小范围。

本课总结

  • 条件类型依据可赋值关系选择类型结果,不是运行时判断
  • infer 可以在匹配结构的同时提取内部类型
  • 裸类型参数会对联合类型分发,使用元组包装可以关闭分发

下一课预告

下一课将继续组合映射类型、索引访问类型和条件类型,构造更实用的可复用类型工具。

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

目录与阅读设置

阅读设置

17

记录一个想法

编写条件类型

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

登录哪都通