Vue / 系统课时

联合类型与类型收窄

联合类型与类型收窄

联合类型让一个值可以合法地拥有多种形态,但访问成员前必须先证明当前值属于哪一支。本节用一个完整 TypeScript 示例串起条件判定、安全访问、判别联合与 never 穷尽检查,避免用断言掩盖类型风险。

学习目标

  • 能使用 typeof、in 和判别字段缩小联合类型范围
  • 能区分可选属性的安全访问与真正的类型收窄
  • 能用 never 穷尽检查发现新增分支却未处理的问题

从联合类型开始收窄

联合类型使用 | 表示“可能是这些类型中的任意一种”。如果参数类型是 string | { email: string },TypeScript 只允许直接使用两边都确定存在的能力;访问对象属性前,必须先通过条件判断缩小范围。

常用收窄方式各有适用对象:typeof 适合字符串、数字等原始类型;in 适合根据对象是否具有某个键来区分结构;判别联合则让多个对象共享一个字面量字段,例如 status: 'ok' | 'error',通常最适合业务状态建模。

用一个示例处理多形态数据

下面程序同时处理“字符串、邮箱对象、手机对象”三种目标,并用判别字段处理 API 结果。nickname?.trim() 只负责安全访问可选值;真正决定当前联合成员的是前面的 typeof、in 或 status 判断。

ts
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 的项目中执行:

bash
npx tsc index.ts --target ES2020 --module commonjs --outDir dist && node dist/index.js

预期输出:

text
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 会在编译阶段报错。这种写法把“新增状态后必须同步处理所有分支”变成类型系统可检查的约束,特别适合请求状态、消息类型和业务事件。

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

目录与阅读设置

阅读设置

17

记录一个想法

联合类型与类型收窄

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

登录哪都通