JavaScript / TypeScript / 系统课时

设计可辨识联合

设计可辨识联合

可辨识联合用一个公共的字面量字段把多种业务状态组织成一个类型。代码只要检查这个字段,TypeScript 就能自动收窄到对应成员;再配合 never,新增状态却遗漏处理分支时会直接暴露在编译阶段。

学习目标

  • 用公共判别字段建模互斥的业务状态
  • 在 switch 分支中获得自动类型收窄
  • 使用 never 检查新增成员后遗漏的处理分支

用稳定字段描述互斥状态

判别字段通常命名为 status、type 或 kind,每个联合成员给它一个不同的字符串字面量。成员自己的数据只放在对应状态中,这样就不会出现“状态是成功,但错误信息也同时存在”的非法组合。

ts
type LoadState =
  | { status: "idle" }
  | { status: "loading" }
  | { status: "success"; data: string[] }
  | { status: "error"; message: string };

这里的 status 就是判别字段。data 只属于 success,message 只属于 error,因此类型本身已经表达了业务约束。

在分支中自动收窄

下面的完整示例根据 status 渲染不同结果。进入每个 case 后,TypeScript 会把 state 收窄成唯一对应的联合成员。

ts
type LoadState =
  | { status: "idle" }
  | { status: "loading" }
  | { status: "success"; data: string[] }
  | { status: "error"; message: string };

function render(state: LoadState): string {
  // 判别字段让每个 case 自动获得对应成员的属性
  switch (state.status) {
    case "idle":
      return "Not started";
    case "loading":
      return "Loading";
    case "success":
      return `Loaded ${state.data.length} items`;
    case "error":
      return `Error: ${state.message}`;
    default: {
      // 新增联合成员却遗漏 case 时,这里会产生编译错误
      const unreachable: never = state;
      return unreachable;
    }
  }
}

console.log(render({ status: "success", data: ["A", "B"] }));

预期输出

text
Loaded 2 items

关键点不是 switch 本身,而是 case "success" 之后可以直接访问 state.data,因为其他成员已经被排除。

用 never 检查遗漏分支

never 表示“不可能出现的值”。当所有联合成员都已被前面的分支处理后,default 中的 state 应当收窄为 never。如果以后加入 status: "cancelled" 却忘记新增对应的 case,state 将不再是 never,赋值语句会产生类型错误。

这种检查把“新增状态时记得同步修改所有处理逻辑”从团队约定变成编译器约束,特别适合状态机、领域事件、请求状态和消息类型等会持续扩展的模型。

判别字段要满足的条件

  • 每个联合成员都包含同名判别字段
  • 判别值使用互不相同的字面量类型,而不是宽泛的 string
  • 判别字段保持稳定且尽量必填,不要用多个布尔值组合模拟状态

如果一个对象允许 loading: true、success: true 同时出现,布尔字段很难表达互斥关系;改成单一 status 后,非法状态会直接失去类型表示空间。

适合使用的边界

当业务对象存在一组明确、互斥且每种状态携带不同数据的分支时,可辨识联合通常比可选属性更安全。若只是几个彼此独立的开关,不存在互斥状态或分支专属数据,就没必要为了使用联合而强行增加判别字段。

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

目录与阅读设置

阅读设置

17

记录一个想法

设计可辨识联合

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

登录哪都通