JavaScript / TypeScript / 系统课时
穷尽性检查
穷尽性检查
联合类型新增成员后,旧的分支处理函数可能悄悄漏掉新情况。本课使用 never 构造穷尽性检查,使未处理的成员无法通过编译,并为运行时异常提供最后一道保护。
学习目标
- 理解
never表示不可能出现的值 - 使用
assertNever检查分支完整性 - 在扩展联合类型时利用编译错误定位遗漏
never 与不可能分支
当所有联合成员都已被排除后,剩余值的类型就是 never。因此,可以把默认分支中的值传给只接受 never 的函数。
// 新增成员时让默认分支产生类型错误
type RequestState =
| { status: "idle" }
| { status: "loading" }
| { status: "success"; data: string }
| { status: "error"; message: string };
function assertNever(value: never): never {
throw new Error(`Unhandled state: ${String(value)}`);
}
function renderState(state: RequestState): string {
switch (state.status) {
case "idle":
return "Ready";
case "loading":
return "Loading...";
case "success":
return `Data: ${state.data}`;
case "error":
return `Error: ${state.message}`;
default:
return assertNever(state);
}
}
console.log(renderState({ status: "idle" }));
console.log(renderState({ status: "success", data: "OK" }));预期输出:
Ready
Data: OK当前四个成员都已处理,所以默认分支中的 state 是 never。若再加入 { status: "cancelled" } 却没有新增对应 case,assertNever(state) 会产生类型错误。
为什么保留默认分支
编译期检查只覆盖经过 TypeScript 校验的代码。运行时仍可能接收到旧版本、外部接口或手工构造的异常数据,因此 assertNever 中的抛错也是必要的防线。
使用条件
穷尽性检查最适合判别联合和有限字面量联合。项目应开启严格类型检查,并避免在分支前使用宽泛断言,否则可能提前抹掉编译器需要的信息。
用新增成员验证防线
在 RequestState 中临时加入 cancelled 成员,然后保持 switch 不变,类型检查应在 assertNever(state) 调用处失败。补齐该 case 后再通过。这比只观察当前两个输出更能证明穷尽性检查有作用;检查完成后撤销临时成员,保持示例与输出一致。
assertNever 接受 never,不是 unknown 或整个联合。如果把参数改成宽类型,默认分支就不再能发现遗漏。它的返回类型也是 never,表示正常控制流不会从这个函数返回,throw 负责在真实异常数据到来时终止当前路径。
未知外部数据应先校验再进入 renderState。默认抛错只是最后一道防线,不会替代输入校验,也不应把原始敏感对象完整写入日志。应用入口可把异常转换成受控错误响应,同时保留可定位的状态标识。字面量成员越来越多时,要继续维护同一个联合来源,避免 UI 与后端各自声明一份不同列表。
独立验证
使用 TypeScript 5.9.3 和 Node.js 22 检查本节。先核对 Ready 与 Data: OK,然后临时新增 cancelled 成员却不增加 case,确认错误出现在 assertNever 调用处。补齐分支或撤销新增成员后才应恢复通过。把主示例保存为独立目录的 main.ts,执行 npx tsc main.ts --strict --target ES2022 --module commonjs --outDir dist,预期退出码为 0;再执行 node dist/main.js 核对上述结果。说明性片段按其上下文编译,练习目录保持 CommonJS 模块约定。