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。

ts
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));
}

运行命令:

bash
npx tsc typeof-narrowing.ts --target ES2020 --module commonjs
node typeof-narrowing.js

预期输出:

text
文本:TYPESCRIPT
数字:42.00
布尔值:真
函数结果:ready
空值

在字符串分支中,value 不再是完整联合类型,而是 string;离开该分支后,编译器会排除已经返回的成员,并继续分析剩余类型。这种基于条件和返回路径的推导称为控制流收窄。

判断顺序会影响结果

typeof null 的结果是 "object",所以判断对象前应先排除 null。数组和普通对象也都会得到 "object",不能仅靠 typeof 区分它们;数组应使用 Array.isArray(),类实例通常使用 instanceof,普通对象结构则可配合属性检查或自定义类型守卫。

多个类型可以写在同一条件中,但收窄结果仍是联合类型。例如同时接受字符串和数字后,分支内只能直接使用两者共有的成员;要调用 trim() 或 toFixed(),仍需继续细分。

适合与不适合的场景

typeof 最适合判断 JavaScript 基础类型和函数,代码短且编译器能够直接理解。对于复杂接口对象,不要把大量属性判断堆在业务分支中,应提取为类型守卫函数,让验证逻辑集中、可复用并便于测试。

还要注意,类型收窄依赖当前控制流。如果变量在判断后被重新赋值,编译器会根据新值重新计算类型,不能假设此前的判断永久有效。

本课总结

  • typeof 判断既在运行时生效,也会驱动 TypeScript 的控制流收窄。
  • null、数组和普通对象不能只靠 "object" 分支准确区分。
  • 分支越精确,可安全调用的类型专属属性和方法就越明确。

下一课预告

下一课将继续使用相等性判断、真值判断或其他类型守卫,处理 typeof 无法精确区分的联合类型。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 typeof 收窄

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

登录哪都通