Vue / 系统课时
联合类型与类型收窄
联合类型与类型收窄
联合类型让一个值可以合法地拥有多种形态,但访问成员前必须先证明当前值属于哪一支。本节用一个完整 TypeScript 示例串起条件判定、安全访问、判别联合与 never 穷尽检查,避免用断言掩盖类型风险。
学习目标
- 能使用
typeof、in和判别字段缩小联合类型范围 - 能区分可选属性的安全访问与真正的类型收窄
- 能用
never穷尽检查发现新增分支却未处理的问题
从联合类型开始收窄
联合类型使用 | 表示“可能是这些类型中的任意一种”。如果参数类型是 string | { email: string },TypeScript 只允许直接使用两边都确定存在的能力;访问对象属性前,必须先通过条件判断缩小范围。
常用收窄方式各有适用对象:typeof 适合字符串、数字等原始类型;in 适合根据对象是否具有某个键来区分结构;判别联合则让多个对象共享一个字面量字段,例如 status: 'ok' | 'error',通常最适合业务状态建模。
用一个示例处理多形态数据
下面程序同时处理“字符串、邮箱对象、手机对象”三种目标,并用判别字段处理 API 结果。nickname?.trim() 只负责安全访问可选值;真正决定当前联合成员的是前面的 typeof、in 或 status 判断。
type Target =
| string
| { email: string; nickname?: string }
| { phone: string };
type ApiResult =
| { status: 'ok'; data: string }
| { status: 'error'; message: string };
function formatTarget(target: Target): string {
if (typeof target === 'string') {
return `id:${target}`;
}
if ('email' in target) {
const displayName = target.nickname?.trim() || 'anonymous';
return `${displayName}<${target.email}>`;
}
return `tel:${target.phone}`;
}
function assertNever(value: never): never {
throw new Error(`Unhandled value: ${JSON.stringify(value)}`);
}
function formatResult(result: ApiResult): string {
switch (result.status) {
case 'ok':
return `data:${result.data}`;
case 'error':
return `error:${result.message}`;
default:
return assertNever(result);
}
}
console.log(formatTarget('u-100'));
console.log(formatTarget({ email: 'dev@example.com', nickname: 'Ada' }));
console.log(formatTarget({ phone: '13800000000' }));
console.log(formatResult({ status: 'ok', data: 'saved' }));将代码保存为 index.ts,在已安装 TypeScript 的项目中执行:
npx tsc index.ts --target ES2020 --module commonjs --outDir dist && node dist/index.js预期输出:
id:u-100
Ada<dev@example.com>
tel:13800000000
data:saved理解安全访问与类型收窄的区别
可选链 ?. 和空值合并 ?? 解决的是“这个属性可能没有值”,并不会自动证明一个联合值属于某个对象分支。例如 target.nickname?.trim() 只有在 TypeScript 已经确定 target 是包含 nickname 的那一支之后才合法。
因此不要用 as 强行把联合类型断言成某个成员来绕过检查。断言不会生成运行时验证;如果真实数据属于另一支,编译器被绕开后仍可能在运行时出错。能用条件表达事实时,应优先使用可执行的判定条件。
用穷尽检查保护未来变更
assertNever 的参数要求是 never。当 switch 已覆盖 ApiResult 的全部成员时,default 中的 result 会被收窄为 never,因此代码可以通过编译。
如果以后新增 { status: 'loading' },却忘记增加对应的 case,default 中的 result 就不再是 never,TypeScript 会在编译阶段报错。这种写法把“新增状态后必须同步处理所有分支”变成类型系统可检查的约束,特别适合请求状态、消息类型和业务事件。