类型谓词(Type Predicate)
一句话解释
'x is T' 是类型守卫返回类型,告诉 TypeScript 在 if/else 分支中收窄类型。
用大白话说
类型谓词是形如 parameterName is Type 的函数返回类型。当函数返回 true 时,TypeScript 在 if 分支中将参数收窄为该类型。这比布尔返回更强大,因为它启用了类型收窄。没有它,TypeScript 只知道函数返回布尔——无法收窄类型。常见用例:检查值是否为特定类型(isString、isError)、区分联合类型成员、验证 API 响应。asserts 关键字变体抛出异常而非返回布尔。
示例
typescript
function isString(value: unknown): value is string {
return typeof value === "string";
}
function process(value: unknown) {
if (isString(value)) {
// value is narrowed to string here
console.log(value.toUpperCase());
} else {
// value is still unknown here
}
}
// Asserts variant — throws if false
function assertDefined<T>(val: T): asserts val is NonNullable<T> {
if (val === null || val === undefined) throw new Error("Null");
}value is string 在 if 分支中收窄类型。asserts val is NonNullable<T> 在值为 null/undefined 时抛出异常。
常见混淆
容易混淆的对象: 布尔返回
关键区别: 布尔返回告诉 TypeScript 函数返回 true/false 但不收窄类型。类型谓词(x is T)告诉 TypeScript 当函数返回 true 时参数是 T 类型——在分支中启用类型收窄。
相关术语
相关资源
相关课程
- TypeScript 类型守卫
类型谓词。
解读错误信息
用大白话解释常见错误——什么意思、为什么发生、如何修复。