第27章 类型守卫

案例27:类型守卫——自定义可辨识联合的类型收窄

在 TypeScript 中,typeof 与 instanceof 可处理基础类型,但面对自定义对象结构(如接口联合)时,需要编写类型守卫函数,让编译器在条件分支中自动收窄类型。

设计思路

定义两个接口 Circle 与 Square,二者具有不同的标识字段 kind。编写 isCircle 守卫函数,返回值为 shape is Circle 形式,使 if 分支内 TypeScript 能推断出具体类型,从而安全访问各自专属属性。

核心代码

interface Circle {
  kind: "circle";
  radius: number;
}

interface Square {
  kind: "square";
  sideLength: number;
}

type Shape = Circle | Square;

function isCircle(shape: Shape): shape is Circle {
  return shape.kind === "circle";
}

function calcArea(shape: Shape): number {
  if (isCircle(shape)) {
    // 此处 shape 自动收窄为 Circle
    return Math.PI * shape.radius ** 2;
  }
  // 剩余分支自动收窄为 Square
  return shape.sideLength ** 2;
}

console.log(calcArea({ kind: "circle", radius: 2 }));  // 12.57
console.log(calcArea({ kind: "square", sideLength: 3 })); // 9

运行结果验证

使用 ts-node 或编译后运行,输出分别为:12.566370614359172 和 9。若传入非法对象(如 { kind: "triangle" }),编译器会直接报错。

成功要点

类型谓词 shape is Circle 是守卫的核心语法,必须返回布尔值;建议对联合类型使用可辨识字段(如 kind),避免复杂逻辑判断。

常见陷阱

不要用 as 强制断言代替守卫,这破坏了类型安全;守卫函数内部逻辑复杂时,要确保所有联合成员都能被正确覆盖。

测试建议

编写三个测试用例:合法圆形、合法正方形、非法形状(编译期报错)。可配合 tsc --strict 检查类型收窄是否完整。

注意事项

守卫函数不改变运行时行为,仅用于静态类型收窄;若联合类型新增成员,请同步更新守卫函数,否则可能导致遗漏分支。