JavaScript / TypeScript / 系统课时
编写类型谓词
编写类型谓词
当同一段运行时判断在多处重复出现时,可以把它封装成返回类型谓词的函数。这样既保留真实校验,又能让 TypeScript 在分支、数组过滤等位置自动收窄类型,减少重复断言和属性探测。
学习目标
- 掌握
参数名 is 目标类型的类型谓词语法 - 编写可复用的自定义类型守卫
- 理解类型谓词的可信边界与常见误用
类型谓词的语法与作用
普通函数返回 boolean 时,调用方只知道结果是真或假,不一定知道结果与参数类型之间的关系。类型谓词把这种关系写进返回类型,使控制流分析能够在返回 true 的分支中收窄参数。
片段示例,Source 与 Target 代表调用方已有的源类型和目标类型:
function isTarget(value: Source): value is Target {
return checkValue(value);
}value is Target 不是运行时表达式,而是给编译器的类型信息。函数体仍然必须返回布尔值,并由开发者保证判断逻辑足以证明目标类型。谓词左侧必须使用当前函数的参数名,目标类型也必须与参数原始类型兼容。
编写可复用的类型守卫
下面的完整示例把猫和狗的区分逻辑封装为 isCat,随后在条件分支和 filter 中复用。
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));预期输出:
Mimi is a cat
meow
Coco is a dog
woof
[ 'Mimi' ]在 if 的真分支中,pet 被收窄为 Cat;假分支则依据联合类型排除 Cat,得到 Dog。pets.filter(isCat) 的结果也会被推断为 Cat[],无需再写类型断言。
可信边界与使用建议
类型谓词相当于开发者向编译器作出的承诺,编译器不会验证函数体是否真的能证明目标类型。下面是片段示例,依赖上文的 Pet 与 Cat 定义;它虽然能通过类型检查,但逻辑并不可靠:
function isCatUnsafe(pet: Pet): pet is Cat {
return true;
}传入 Dog 后,它仍会被当成 Cat,调用 meow() 时将产生运行时错误。可靠的守卫应优先检查稳定的可辨识字段,例如字面量 kind;面对接口响应等外部数据时,还要逐项验证关键属性及其类型。
当检查逻辑只在一处使用,直接写 typeof、in 或可辨识联合通常更直观;当判断会被多个分支、集合操作或业务模块复用时,再提取为命名清晰的类型谓词函数。
本课总结
- 类型谓词使用
参数名 is 目标类型描述布尔结果与类型收窄的关系 - 自定义守卫既要返回布尔值,也要用真实运行时检查兑现类型承诺
- 类型谓词可在条件分支和
filter等高阶函数中复用
下一课预告
下一课将学习断言函数,用 asserts 表达“校验失败就终止,成功后类型确定”的控制流效果。