JavaScript / TypeScript / 系统课时

使用 in 与 instanceof

使用 in 与 instanceof

对象类型不能只靠类型断言来区分。in 根据属性是否存在判断对象结构,instanceof 根据原型链判断对象是否由某个构造器创建。本课通过完整示例掌握两者的使用条件、收窄结果和常见边界。

学习目标

  • 使用 in 根据属性存在性收窄联合类型
  • 使用 instanceof 识别类实例和内置对象
  • 根据数据来源选择结构判断或实例判断

两种保护分别判断什么

'property' in object 检查属性是否存在于对象自身或其原型链中,适合区分具有不同字段的对象联合类型。它关注的是结构,不要求对象由某个类创建。

value instanceof Constructor 检查构造器的 prototype 是否出现在对象原型链上,适合 Error、Date 和自定义类实例等运行时对象。字段完全相同但原型不同的普通对象,不会因此成为某个类的实例。

在完整示例中完成收窄

下面的 readResult 用 in 区分接口成功与失败结果,formatError 用 instanceof 区分自定义错误和普通错误。hasId 则演示处理 unknown 时,必须先确认右侧是非空对象。

ts
type ApiSuccess = {
  status: 200;
  data: string;
};

type ApiFailure = {
  status: 400 | 500;
  error: string;
};

class NetworkError extends Error {
  constructor(
    message: string,
    public readonly retryable: boolean
  ) {
    super(message);
    this.name = 'NetworkError';
  }
}

function readResult(result: ApiSuccess | ApiFailure): string {
  // 两种结果拥有不同字段,使用 in 检查结构最直接
  if ('error' in result) {
    return `请求失败:${result.error}`;
  }

  return `请求成功:${result.data}`;
}

function formatError(error: unknown): string {
  // 先判断更具体的子类,再回退到通用 Error
  if (error instanceof NetworkError) {
    return `网络错误:${error.message},可重试:${error.retryable}`;
  }

  if (error instanceof Error) {
    return `普通错误:${error.message}`;
  }

  return '未知错误';
}

function hasId(value: unknown): value is { id: unknown } {
  return typeof value === 'object' && value !== null && 'id' in value;
}

console.log(readResult({ status: 200, data: '订单已创建' }));
console.log(readResult({ status: 500, error: '服务暂不可用' }));
console.log(formatError(new NetworkError('连接超时', true)));
console.log(formatError(new Error('参数格式错误')));
console.log(formatError('unexpected'));
console.log(hasId({ id: 7 }));
console.log(hasId(null));

预期输出:

text
请求成功:订单已创建
请求失败:服务暂不可用
网络错误:连接超时,可重试:true
普通错误:参数格式错误
未知错误
true
false

instanceof 的判断顺序很重要。自定义错误通常也继承自 Error,若先检查 error instanceof Error,更具体的 NetworkError 分支就不会执行。

根据数据来源选择保护方式

来自 JSON.parse、HTTP 响应或数据库结果的普通对象通常没有自定义类的原型链。即使字段与某个类完全一致,instanceof 也可能返回 false,这类数据应使用 in、typeof、判别字段或校验器检查结构。

应用进程中直接创建的类实例,以及 Error、Date、Map 等内置对象,适合使用 instanceof。不过跨 iframe 或不同 JavaScript Realm 的对象可能拥有不同构造器,此时也应改用结构或品牌字段判断。

in 右侧必须是对象,因此处理 unknown 时要先排除 null。此外,'name' in object 只证明属性存在;对象为 { name: undefined } 时结果仍是 true,继续使用前还要校验属性值的类型和有效性。

当联合类型拥有稳定的字面量字段时,例如 type: 'success' | 'failure',优先使用判别字段通常比检查业务属性更清楚。in 更适合没有统一判别字段、但成员结构存在明显差异的对象。

类型断言 as SomeType 不执行运行时检查,也不会因为断言成功就让数据真正符合该类型。面对外部数据,应先验证再使用,而不是用断言绕过编译器。

本课总结

  • in 根据属性结构收窄,适合普通对象和接口返回数据
  • instanceof 根据原型链收窄,适合类实例与内置对象
  • 判断 unknown 前先确认它是非空对象,属性存在后仍要验证属性值

下一课预告

下一课将继续学习自定义类型保护函数,把重复的运行时检查封装成可复用、可被 TypeScript 识别的类型谓词。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 in 与 instanceof

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

登录哪都通