JavaScript / TypeScript / 系统课时
使用 typeof 收窄
使用 typeof 收窄
当一个变量可能是字符串、数字、布尔值或函数时,直接调用专属方法会触发类型错误。本课使用 typeof 建立运行时判断,让 TypeScript 在对应分支中自动获得更具体的类型。
学习目标
- 使用
typeof收窄常见基础类型和函数类型 - 理解分支判断如何影响后续代码中的类型
- 避开
null、数组和普通对象的判断陷阱
typeof 能识别什么
typeof 是 JavaScript 的运行时运算符,TypeScript 会读取判断结果并进行控制流分析。常见返回值包括 "string"、"number"、"boolean"、"undefined"、"bigint"、"symbol"、"function" 和 "object"。
| 判断条件 | 分支中的类型 | 适合的操作 |
|---|---|---|
typeof value === "string" |
string |
trim()、toUpperCase() |
typeof value === "number" |
number |
算术运算、toFixed() |
typeof value === "boolean" |
boolean |
条件判断 |
typeof value === "function" |
函数类型 | 安全调用 |
在分支中完成收窄
下面的函数接收五种可能值。每个分支先判断类型,再执行该类型独有的操作;所有成员被处理后,末尾变量会被收窄为 never。
type Input = string | number | boolean | (() => string) | null;
function describe(value: Input): string {
// null 的 typeof 结果是 object,因此必须优先单独判断
if (value === null) {
return "空值";
}
if (typeof value === "string") {
return `文本:${value.toUpperCase()}`;
}
if (typeof value === "number") {
return `数字:${value.toFixed(2)}`;
}
if (typeof value === "boolean") {
return value ? "布尔值:真" : "布尔值:假";
}
if (typeof value === "function") {
return `函数结果:${value()}`;
}
const unreachable: never = value;
return unreachable;
}
const inputs = ["TypeScript", 42, true, () => "ready", null] satisfies Input[];
for (const item of inputs) {
console.log(describe(item));
}运行命令:
npx tsc typeof-narrowing.ts --target ES2020 --module commonjs
node typeof-narrowing.js预期输出:
文本:TYPESCRIPT
数字:42.00
布尔值:真
函数结果:ready
空值在字符串分支中,value 不再是完整联合类型,而是 string;离开该分支后,编译器会排除已经返回的成员,并继续分析剩余类型。这种基于条件和返回路径的推导称为控制流收窄。
判断顺序会影响结果
typeof null 的结果是 "object",所以判断对象前应先排除 null。数组和普通对象也都会得到 "object",不能仅靠 typeof 区分它们;数组应使用 Array.isArray(),类实例通常使用 instanceof,普通对象结构则可配合属性检查或自定义类型守卫。
多个类型可以写在同一条件中,但收窄结果仍是联合类型。例如同时接受字符串和数字后,分支内只能直接使用两者共有的成员;要调用 trim() 或 toFixed(),仍需继续细分。
适合与不适合的场景
typeof 最适合判断 JavaScript 基础类型和函数,代码短且编译器能够直接理解。对于复杂接口对象,不要把大量属性判断堆在业务分支中,应提取为类型守卫函数,让验证逻辑集中、可复用并便于测试。
还要注意,类型收窄依赖当前控制流。如果变量在判断后被重新赋值,编译器会根据新值重新计算类型,不能假设此前的判断永久有效。
本课总结
typeof判断既在运行时生效,也会驱动 TypeScript 的控制流收窄。null、数组和普通对象不能只靠"object"分支准确区分。- 分支越精确,可安全调用的类型专属属性和方法就越明确。
下一课预告
下一课将继续使用相等性判断、真值判断或其他类型守卫,处理 typeof 无法精确区分的联合类型。