联合类型是什么?
参考答案
定义
联合类型(Union Type)用 | 表示"值可以是其中任意一种类型":
let id: string | number;
type Status = 'pending' | 'success' | 'error'; // 字面量联合
使用规则
- 赋值:只要符合任一成员即可。
- 使用:只能访问所有成员共有的属性/方法,否则需要收窄:
function fmt(v: string | number) {
v.toFixed(2); // ❌ 报错:string 没有 toFixed
if (typeof v === 'number') v.toFixed(2); // ✅ 收窄
}
- 共有属性可访问:
{a:1} | {a:2, b:3}只能访问a。
收窄手段
typeof、instanceof、in、Array.isArray、字面量判别(可辨识联合 discriminant)、自定义守卫 is、switch 穷尽检查。
可辨识联合(Discriminated Union)
type Result =
| { ok: true; data: string }
| { ok: false; error: Error };
function handle(r: Result) {
if (r.ok) r.data; // 靠 ok 字段自动收窄
else r.error;
}
这是最实用的模式:用一个公共字面量字段区分成员,配合 switch + never 做穷尽校验。
与交叉类型
- 联合
A | B:满足其一即可,属性取交集(能用的是共有部分)。 - 交叉
A & B:必须同时满足,属性取并集。 - 优先级:
A & B | C中&高于|,必要时加括号。
注意
- 联合类型不是"两种类型同时存在",而是"编译期不确定是哪个",因此不能直接调用成员独有方法。
- 数组的联合
(string | number)[]与string[] | number[]语义不同,后者要求整个数组统一类型。 - 分布式条件类型遇到联合类型会逐成员分发,这是
Exclude等工具类型的基础。