JavaScript / TypeScript / 系统课时

编写类型谓词

编写类型谓词

当同一段运行时判断在多处重复出现时,可以把它封装成返回类型谓词的函数。这样既保留真实校验,又能让 TypeScript 在分支、数组过滤等位置自动收窄类型,减少重复断言和属性探测。

学习目标

  • 掌握 参数名 is 目标类型 的类型谓词语法
  • 编写可复用的自定义类型守卫
  • 理解类型谓词的可信边界与常见误用

类型谓词的语法与作用

普通函数返回 boolean 时,调用方只知道结果是真或假,不一定知道结果与参数类型之间的关系。类型谓词把这种关系写进返回类型,使控制流分析能够在返回 true 的分支中收窄参数。

片段示例,Source 与 Target 代表调用方已有的源类型和目标类型:

ts
function isTarget(value: Source): value is Target {
  return checkValue(value);
}

value is Target 不是运行时表达式,而是给编译器的类型信息。函数体仍然必须返回布尔值,并由开发者保证判断逻辑足以证明目标类型。谓词左侧必须使用当前函数的参数名,目标类型也必须与参数原始类型兼容。

编写可复用的类型守卫

下面的完整示例把猫和狗的区分逻辑封装为 isCat,随后在条件分支和 filter 中复用。

ts
interface Cat {
  kind: "cat";
  name: string;
  meow(): void;
}

interface Dog {
  kind: "dog";
  name: string;
  bark(): void;
}

type Pet = Cat | Dog;

function isCat(pet: Pet): pet is Cat {
  return pet.kind === "cat";
}

const pets: Pet[] = [
  {
    kind: "cat",
    name: "Mimi",
    meow: () => console.log("meow")
  },
  {
    kind: "dog",
    name: "Coco",
    bark: () => console.log("woof")
  }
];

for (const pet of pets) {
  if (isCat(pet)) {
    console.log(`${pet.name} is a cat`);
    pet.meow();
  } else {
    console.log(`${pet.name} is a dog`);
    pet.bark();
  }
}

const cats = pets.filter(isCat);
console.log(cats.map((cat) => cat.name));

预期输出:

text
Mimi is a cat
meow
Coco is a dog
woof
[ 'Mimi' ]

在 if 的真分支中,pet 被收窄为 Cat;假分支则依据联合类型排除 Cat,得到 Dog。pets.filter(isCat) 的结果也会被推断为 Cat[],无需再写类型断言。

可信边界与使用建议

类型谓词相当于开发者向编译器作出的承诺,编译器不会验证函数体是否真的能证明目标类型。下面是片段示例,依赖上文的 Pet 与 Cat 定义;它虽然能通过类型检查,但逻辑并不可靠:

ts
function isCatUnsafe(pet: Pet): pet is Cat {
  return true;
}

传入 Dog 后,它仍会被当成 Cat,调用 meow() 时将产生运行时错误。可靠的守卫应优先检查稳定的可辨识字段,例如字面量 kind;面对接口响应等外部数据时,还要逐项验证关键属性及其类型。

当检查逻辑只在一处使用,直接写 typeof、in 或可辨识联合通常更直观;当判断会被多个分支、集合操作或业务模块复用时,再提取为命名清晰的类型谓词函数。

本课总结

  • 类型谓词使用 参数名 is 目标类型 描述布尔结果与类型收窄的关系
  • 自定义守卫既要返回布尔值,也要用真实运行时检查兑现类型承诺
  • 类型谓词可在条件分支和 filter 等高阶函数中复用

下一课预告

下一课将学习断言函数,用 asserts 表达“校验失败就终止,成功后类型确定”的控制流效果。

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

目录与阅读设置

阅读设置

17

记录一个想法

编写类型谓词

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

登录哪都通