第91章 never类型

案例题目:never 类型——穷尽检查与不可达分支

本案例通过一个“交通信号灯”状态处理函数,演示 never 类型在穷尽检查中的核心作用:当所有可能的分支都被处理后,剩余代码应标记为不可达。

设计思路

定义联合类型 Signal,包含三个成员。switch 语句逐一处理每个成员,并在最后添加一个接收 never 参数的兜底函数。若未来联合类型新增成员而忘记处理,TypeScript 会编译报错,从而在开发阶段拦截遗漏。

核心代码

type Signal = 'red' | 'yellow' | 'green';

function assertNever(value: never): never {
  throw new Error('Unexpected signal: ' + value);
}

function getAction(signal: Signal): string {
  switch (signal) {
    case 'red':
      return 'Stop';
    case 'yellow':
      return 'Wait';
    case 'green':
      return 'Go';
    default:
      return assertNever(signal); // 穷尽检查关键点
  }
}

console.log(getAction('red'));      // Stop
console.log(getAction('yellow'));   // Wait
console.log(getAction('green'));    // Go
// 若取消注释下一行,将在编译时报错(参数类型不匹配)
// console.log(getAction('blue'));
黄底提示:将 Signal 类型添加 'blue' 成员后,default 分支的 signal 会变为 string,此时 assertNever 参数类型不符,TypeScript 编译立即报错。
蓝底技巧:never 类型是所有类型的子类型,但没有任何类型是 never 的子类型(除了 never 自身)。利用这个特性,可以安全地实现穷尽检查。
红底警告:运行时若传入未预期的值(如通过 as any 绕过类型检查),assertNever 会抛出异常,防止静默错误继续传播。
绿底成果:编译通过且输出三个操作结果,表明所有分支已完备处理;代码即文档,未来扩展类型时编译器会自动提示遗漏位置。

运行结果

执行 tsc 编译后运行 JS 文件,控制台依次输出:Stop、Wait、Go。若将 Signal 扩展为包含 'blue',编译阶段即终止并报告错误。

注意事项

1) never 函数必须显式返回 never 或抛出异常,不能写 void;2) 若 switch 覆盖所有情况,default 分支可省略,但保留更有防御性。