Skip to content

类型谓词(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 类型——在分支中启用类型收窄。

相关术语

相关资源

相关课程

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误

← 返回术语表