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 判断基础值和函数,让编译器在不同分支中自动收窄联合类型。
按自己的节奏,确认真正理解。