筛出成员还是检查整体:条件类型

区分逐成员变换与整体判断,并应用到共有键与全部键。

本章目录CONTENTS ↓

一个候选集合同时包含文本状态和数字编号。文本处理工具只想保留其中的文本;另一个工具却要求所有候选都能当作文本,混入数字就拒绝整个输入。面对同一个联合,这两个需求应得到不同结果。

因此“条件成立吗”还不够,必须说明判断单位:逐个成员,还是整个输入。条件类型提供类型层的分支;裸类型参数触发联合分配,元组包装则让这里的检查作用于整体。

用同一个输入对比两种语义

type FilterStrings<T> = T extends string ? T : never;
type KeepIfAllStrings<T> = [T] extends [string] ? T : never;
type Selected = FilterStrings<"draft" | 42>; // "draft"
type Rejected = KeepIfAllStrings<"draft" | 42>; // never
type Accepted = KeepIfAllStrings<"draft" | "published">;
// "draft" | "published"

第一种定义的条件左侧直接是类型参数 T。联合代入后,各成员分别判断,结果再合成联合。第二种左侧是 [T],不触发这种分配;整体中只要仍可能有数字,就不能满足字符串要求。元组包装属于类型表达式,不会产生运行时数组。

extends 判断可赋值性,而非完全相等;"draft" 可以赋给 string。条件决定走哪一支,分支表达式决定保留或生成什么。

筛选完整成员,而不是只保留匹配条件

type AppEvent =
| { kind: "saved"; id: string }
| { kind: "failed"; error: string }
| { kind: "progress"; percent: number };
type Finished = Extract<AppEvent, { kind: "saved" | "failed" }>;
// { kind: "saved"; id: string } | { kind: "failed"; error: string }
type KeepMember<T, U> = T extends U ? T : never;
type ReturnTarget<T, U> = T extends U ? U : never;
type LabelsOnly = ReturnTarget<AppEvent, { kind: "saved" | "failed" }>;
// { kind: "saved" | "failed" }

Extract 的筛选逻辑相当于 KeepMember:逐个匹配,返回原成员,所以 id、error 得以保留。若真分支换成 U,就只留下目标描述。匹配成功并不自动保留输入信息。

这个例子依据结构可赋值性匹配,不要求成员只有 kind 一个属性。它与新对象字面量赋值时的额外属性检查不是同一个检查场景。

抽取工具时,检查分配是否改变

type IsString<V> = V extends string ? true : false;
type Direct<T> = {
[K in keyof T]: T[K] extends string ? true : false
};
type ViaHelper<T> = {
[K in keyof T]: IsString<T[K]>
};
type Whole = Direct<{ id: string | number }>["id"]; // false
type Each = ViaHelper<{ id: string | number }>["id"]; // boolean

直接版本的条件左侧是索引访问 T[K];提取之后,执行条件判断的是 IsString 中的裸参数 V。输入类型相同,定义形状不同,结果也可能不同。类型工具重构同样需要行为验证。

阅读顺序是:定位真正的条件定义 → 看左侧形状 → 明确分配对象 → 分别计算输出。映射遍历键,不代表属性值中的联合也自动分配。

这个区别也会影响可选属性和可空值。delivery?: { promisedAt: Date } 通过索引读取时包含 undefined;shippedAt: Date | null 则含两个候选。直接把这些联合放在 extends Date 或 extends object 左侧,会做整体判断:只要有一个成员不满足,便走假分支。

type DateText<T> = T extends Date ? string : T;
type EachDate = DateText<Date | null>; // string | null
type WholeDate = (Date | null) extends Date ? string : Date | null;
// Date | null

若要让对象的每个属性值都逐成员变换,可在映射中调用一个检查裸参数 T 的泛型工具。完整案例见递归传输模型。

分配也可以用于逐成员变换

type Entity =
| { id: string; name: string }
| { id: number; active: boolean };
type CommonKeys = keyof Entity; // "id"
type Id = Entity["id"]; // string | number
type AllKeys<T> = T extends unknown ? keyof T : never;
type EveryKey = AllKeys<Entity>; // "id" | "name" | "active"

对这里的对象联合,直接 keyof 得到共同可访问的键。AllKeys 先分配,再分别取键,得到所有成员中出现的键。条件虽允许这些成员通过,却不能直接删掉:删掉之后,逐成员操作会变成整体操作。这里用 T extends T 也能触发同样的分配,但 extends unknown 更直接地表明意图。

得到所有键不意味着某个实际对象同时拥有全部属性,因此 EveryKey 不能直接当成任意 Entity 都可读取的键范围。

keyof (A | B) 与 (keyof A) | (keyof B) 的操作顺序不同;keyof 取共有键也不会把原联合缩成只含共有字段的对象。完整推导见联合与交叉的值集合模型。

查阅与验证

核心需要掌握分配对象与输出信息;any、never、交叉类型等边界在遇到时单独验证。特别是裸参数以 never 为输入时,没有成员可分配,结果可能与直觉上的真假判断不同。

用两个成员构造最小例子,并检查中间类型,是定位这类问题的有效方法。官方入口:Conditional Types 与 keyof。完整组合见API 测试用例,整体位置见全景。

这一页,先记到这里。