JavaScript / TypeScript / 系统课时

区分特殊类型

区分特殊类型

TypeScript 的特殊类型用于表达“暂时未知”“不关心返回值”或“逻辑上不可能发生”等边界。本课重点区分 unknown、any、void 与 never,并用一个可运行示例展示如何安全处理外部输入和检查遗漏分支。

学习目标

  • 说清 unknown、any、void 与 never 的职责差异
  • 使用 unknown 接收不可信输入,并在使用前完成类型收窄
  • 使用 never 检查联合类型是否遗漏分支

四种特殊类型的职责

any 会关闭当前值上的大部分类型检查,适合兼容旧代码时临时过渡;unknown 同样可以接收任意值,但读取属性、调用方法或参与运算前必须先证明它的具体类型。面向接口响应、配置文件和用户输入时,应优先选择 unknown。

类型 表达的含义 典型位置 使用限制
any 跳过类型检查 旧代码迁移、缺失类型声明 可直接操作,但容易把错误扩散到后续代码
unknown 值存在,但类型尚未确认 外部输入、反序列化结果 必须先收窄再使用
void 调用方不依赖返回值 日志、事件回调、通知函数 通常用于函数返回类型
never 该位置不可能得到值 抛错函数、死循环、穷尽检查 不能赋入任何正常值

用 unknown 安全处理输入

下面的程序先把 JSON 结果保存为 unknown,再逐层检查对象结构。只有字段满足要求时,数据才会被转换为业务联合类型;这能把不可信数据隔离在解析边界。

ts
type Command =
  | { kind: "start"; port: number }
  | { kind: "stop" };

function isRecord(value: unknown): value is Record<string, unknown> {
  return typeof value === "object" && value !== null;
}

function parseCommand(input: unknown): Command {
  if (!isRecord(input) || typeof input.kind !== "string") {
    throw new Error("命令格式无效");
  }

  if (input.kind === "start" && typeof input.port === "number") {
    return { kind: "start", port: input.port };
  }

  if (input.kind === "stop") {
    return { kind: "stop" };
  }

  throw new Error("不支持的命令");
}

function assertNever(value: never): never {
  throw new Error(`未处理的命令:${JSON.stringify(value)}`);
}

function execute(command: Command): string {
  switch (command.kind) {
    case "start":
      return `服务已在 ${command.port} 端口启动`;
    case "stop":
      return "服务已停止";
    default:
      return assertNever(command);
  }
}

const raw: unknown = JSON.parse('{"kind":"start","port":8080}');
console.log(execute(parseCommand(raw)));

运行命令:

bash
npx tsc special-types.ts --target ES2020 --module commonjs
node special-types.js

预期输出:

text
服务已在 8080 端口启动

示例中的 assertNever 不只是运行时兜底。若以后给 Command 新增一种成员,却忘记在 switch 中处理,默认分支里的参数将不再是 never,编译器会立即报错。

正确使用 void 与 never

void 表示调用方不应依赖返回值,例如日志函数或事件回调。它不等于“函数一定返回 undefined”;在回调类型中,实际函数可以返回值,只是该值会被调用方忽略。

never 表示控制流无法正常到达终点。总是抛出异常、无限循环的函数可以声明为 never,联合类型被完全处理后,剩余变量也会被收窄为 never。不要用 never 表示“可能没有结果”,这种情况通常应使用 undefined、null 或显式结果类型。

常见误区

  • 把 unknown 强制断言成目标类型,只是绕过检查,并没有验证数据。
  • 在业务代码中大面积使用 any,会让一个边界错误扩散为多个运行时错误。
  • 把 void 和 never 混用:前者表示忽略返回值,后者表示根本不会正常返回。

本课总结

  • 外部输入优先声明为 unknown,通过类型守卫后再进入业务逻辑。
  • any 适合受控迁移,不应作为默认类型。
  • never 能表达不可达分支,并帮助联合类型实现穷尽检查。

下一课预告

下一课将使用 typeof 判断基础值和函数,让编译器在不同分支中自动收窄联合类型。

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

目录与阅读设置

阅读设置

17

记录一个想法

区分特殊类型

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

登录哪都通