第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 检查类型收窄是否完整。
注意事项
守卫函数不改变运行时行为,仅用于静态类型收窄;若联合类型新增成员,请同步更新守卫函数,否则可能导致遗漏分支。