深入理解 ESLint 插件 Unicorn 中的 `no-instanceof-builtin-object` 规则

在 JavaScript 开发中，类型检查是一个常见但容易出错的操作。许多开发者习惯使用 instanceof 运算符来判断对象类型，然而这种方式存在一些潜在问题。ESLint 插件 Unicorn 提出的 no-instanceof-builtin-object 规则正是为了解决这些问题而设计的。

instanceof 运算符的局限性

instanceof 运算符在跨域(iframe)或不同 JavaScript 执行环境(如 Node.js 和浏览器)时会出现判断错误。这是因为每个执行环境都有自己独立的全局对象和内置构造函数，导致 instanceof 检查结果不可靠。

例如，当一个 iframe 中的数组被传递到父窗口时，在父窗口中使用 instanceof Array 检查会返回 false，尽管它确实是一个数组对象。

更可靠的类型检查方案

1. 使用 typeof 运算符

对于基本类型(string、number、boolean 等)，typeof 是最简单直接的检查方式：

typeof foo === 'string'  // 检查是否为字符串

2. Node.js 环境下的 node:util/types 模块

Node.js 提供了专门的类型检查工具模块：

import { isNumberObject, isMap } from 'node:util/types';

isNumberObject(new Number(123))  // true
isNumberObject(123)  // false
isMap(new Map())  // true

3. 浏览器环境下的 @sindresorhus/is 模块

对于浏览器环境，可以使用第三方类型检查库：

import is from '@sindresorhus/is';

is(new Map()) === 'Map'  // true

规则的具体要求

no-instanceof-builtin-object 规则禁止对内置对象使用 instanceof 检查，包括但不限于：

• Array
• Map
• Promise
• Error

错误示例

foo instanceof Array
foo instanceof Map
foo instanceof Promise

正确示例

// Node.js 环境
import types from 'node:util/types'
Array.isArray(foo)
types.isMap(foo)
types.isPromise(foo)

// 浏览器环境
import is from '@sindresorhus/is'
is(foo) === 'Array'
is(foo) === 'Map'
is(foo) === 'Promise'

为什么这条规则重要

1. 可靠性：避免了跨环境类型检查的潜在问题
2. 一致性：统一了代码库中的类型检查方式
3. 可维护性：使用专门的类型检查方法使代码意图更清晰
4. 性能：某些专门的类型检查方法可能比 instanceof 更高效

实施建议

对于现有项目，可以逐步引入这条规则：

1. 首先在 ESLint 配置中启用规则
2. 使用 ESLint 的自动修复功能修复简单问题
3. 对于复杂情况，手动替换为适当的类型检查方法
4. 在团队中普及相关知识，确保所有成员理解规则的意义

通过采用 no-instanceof-builtin-object 规则，开发者可以编写出更加健壮和可靠的 JavaScript 代码，避免因环境差异导致的类型判断错误。