JavaScript / TypeScript / 系统课时

in 与 instanceof

in 与 instanceof

当联合类型包含多个对象形态时,必须先确认当前值属于哪一类,才能安全访问专有成员。本课使用 in 检查属性、使用 instanceof 检查运行时实例,并说明两者各自适用的边界。

学习目标

  • 使用 in 根据属性收窄对象联合类型
  • 使用 instanceof 识别类实例和内置对象
  • 避免把类型别名或接口误用于运行时检查

使用 in 检查属性

"属性名" in 对象 会判断属性是否存在,并让 TypeScript 在对应分支中缩小类型范围。它适合区分由接口或对象字面量组成的联合类型。

ts
// 先确认成员能力,再调用该分支的方法
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));

预期输出:

text
Mimi: meow
Coco: woof

in 检查的是属性是否存在,也会查找原型链。若多个联合成员都声明了同名可选属性,该检查未必能把类型缩小到唯一成员。

使用 instanceof 检查实例

instanceof 依赖 JavaScript 运行时中的构造函数,适合类实例、Date、Error 等真实存在的值。接口和类型别名编译后会被删除,不能放在 instanceof 右侧。

ts
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"));

预期输出:

text
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 模块约定。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

in 与 instanceof

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通