JavaScript / TypeScript / 系统课时
in 与 instanceof
in 与 instanceof
当联合类型包含多个对象形态时,必须先确认当前值属于哪一类,才能安全访问专有成员。本课使用 in 检查属性、使用 instanceof 检查运行时实例,并说明两者各自适用的边界。
学习目标
- 使用
in根据属性收窄对象联合类型 - 使用
instanceof识别类实例和内置对象 - 避免把类型别名或接口误用于运行时检查
使用 in 检查属性
"属性名" in 对象 会判断属性是否存在,并让 TypeScript 在对应分支中缩小类型范围。它适合区分由接口或对象字面量组成的联合类型。
// 先确认成员能力,再调用该分支的方法
type Cat = {
name: string;
meow: () => string;
};
type Dog = {
name: string;
bark: () => string;
};
function speak(pet: Cat | Dog): string {
if ("meow" in pet) {
return `${pet.name}: ${pet.meow()}`;
}
return `${pet.name}: ${pet.bark()}`;
}
const cat: Cat = {
name: "Mimi",
meow: () => "meow"
};
const dog: Dog = {
name: "Coco",
bark: () => "woof"
};
console.log(speak(cat));
console.log(speak(dog));预期输出:
Mimi: meow
Coco: woofin 检查的是属性是否存在,也会查找原型链。若多个联合成员都声明了同名可选属性,该检查未必能把类型缩小到唯一成员。
使用 instanceof 检查实例
instanceof 依赖 JavaScript 运行时中的构造函数,适合类实例、Date、Error 等真实存在的值。接口和类型别名编译后会被删除,不能放在 instanceof 右侧。
class ApiError extends Error {
constructor(
message: string,
public readonly code: number
) {
super(message);
}
}
function formatError(error: unknown): string {
if (error instanceof ApiError) {
return `API ${error.code}: ${error.message}`;
}
if (error instanceof Error) {
return `Error: ${error.message}`;
}
return "Unknown error";
}
console.log(formatError(new ApiError("Not Found", 404)));
console.log(formatError(new Error("Network failed")));
console.log(formatError("bad value"));预期输出:
API 404: Not Found
Error: Network failed
Unknown error如何选择
对象只靠结构区分时,优先使用 in;对象由类构造且需要确认原型关系时,使用 instanceof。无论哪种方式,检查条件都必须与后续访问的成员保持一致。
检查存在还不够
对可信的 Cat 或 Dog 联合,meow 字段存在即可选择分支;对未知网络数据,字段存在却可能是数字,仍要继续检查 typeof value.meow 是否为 function。执行 in 之前必须排除 null 和原始值,否则 JavaScript 本身可能抛异常。仅需自有属性时应考虑 Object.hasOwn,并另行验证值类型。
instanceof 检查原型关系,不是结构相似。把 Date 序列化为 JSON 再解析,得到的是字符串或普通数据,不会自动恢复 Date 实例;来自另一个窗口的内置对象也可能有不同构造函数。检查失败后应按数据协议重新解析,不能直接强制断言成实例。
分别运行两个完整示例,第一组检查猫狗分支,第二组检查自定义错误、普通 Error 与字符串。新增一个没有方法的未知对象作为负例时,必须先补运行时校验,不能把原函数的可信联合参数随意改成 any。官方收窄说明 给出了这两类检查的边界。
独立验证
使用 TypeScript 5.9.3 和 Node.js 22 检查本节。把猫狗和错误类两个示例分别保存到独立文件,核对两组输出。检查 null 或未知对象时,先排除非对象,再确认方法可调用,避免把属性存在误当成函数存在。把主示例保存为独立目录的 main.ts,执行 npx tsc main.ts --strict --target ES2022 --module commonjs --outDir dist,预期退出码为 0;再执行 node dist/main.js 核对上述结果。说明性片段按其上下文编译,练习目录保持 CommonJS 模块约定。