30 seconds of code:用 Array.isArray() 正确进行 JavaScript 数组类型检查

原创2026-10-04 12:20:381,610 阅读
文章标签:教程文档

30 seconds of code:用 Array.isArray() 正确进行 JavaScript 数组类型检查

判断一个值是不是数组,是 JavaScript 开发中最常见的类型检查需求之一。本文基于 30 seconds of code 仓库的 typecheck-array 片段展开,系统对比 Array.isArray() 与 instanceof 两种方案的差异,并通过 iframe 跨 realm 示例揭示 instanceof 的失效场景,帮助读者理解数组类型检查的底层原理,掌握在任何运行环境中都稳定可靠的判定方法。

为什么数组需要专门的类型检查

在 JavaScript 中,数组本质上是一种特殊的对象,因此 typeof 对数组返回的是 'object',无法将其与普通对象、null 区分开。这一点在仓库的 complete-guide-to-js-type-checking 片段中有明确印证——它专门给出了 "Value is object" 一节,并附上提示:

Arrays are also considered objects in JavaScript. It is recommended to use Array.isArray() to check if a value is an array.

也就是说,在 30 seconds of code 的类型检查体系中,数组检查被视为独立于通用对象检查的一环,标准做法就是使用 Array.isArray()。判断一个值是否为数组,有两条主要路径:

  • Array.isArray(value):ES5 引入的静态方法,专门用于判断数组;
  • value instanceof Array:instanceof 运算符,沿原型链查找 Array.prototype。

两种方法的日常用法对比

对于常规场景——即数组由数组字面量语法([])或当前全局的 Array 构造函数创建——两种方法都能正确工作:

let array1 = new Array(1, 1, 1, 1);

console.log(array1 instanceof Array); // true
console.log(Array.isArray(array1));   // true
const literalArray = [1, 2, 3];

console.log(literalArray instanceof Array); // true
console.log(Array.isArray(literalArray));   // true

从表面看,二者表现完全一致。但 30 seconds of code 的 typecheck-array 片段明确指出,二者存在一个关键差异:Array.isArray() 更可靠,因为它能正确处理跨 realm 对象(cross-realm objects),例如在 iframe 中创建的数组。

跨 realm 场景:iframe 让 instanceof 失效

"Realm"(领域)是 ECMAScript 规范中的概念,指一个独立的对象环境,包括各自的全局对象及其内建构造器。在浏览器中,每个 iframe 都拥有独立的 realm,因此 iframe 内存在一套独立的 Array 构造器和 Array.prototype。

下面这段来自 typecheck-array 的完整示例,直观展示了问题:

let iframeEl = document.createElement('iframe');
document.body.appendChild(iframeEl);
iframeArray = window.frames[window.frames.length - 1].Array;

let array1 = new Array(1, 1, 1, 1);        // 当前 realm 创建
let array2 = new iframeArray(1, 1, 1, 1);  // iframe realm 创建

console.log(array1 instanceof Array);   // true
console.log(Array.isArray(array1));     // true

console.log(array2 instanceof Array);   // false  ← instanceof 失效
console.log(Array.isArray(array2));     // true   ← Array.isArray 正常

逐步拆解这段代码的执行过程:

  1. 创建一个 iframe 元素并挂载到 document.body,使其拥有独立的窗口与 realm;
  2. 通过 window.frames[window.frames.length - 1].Array 取得 iframe 全局环境中的 Array 构造器;
  3. array1 由当前页面的 Array 构造;array2 由 iframe 的 Array 构造;
  4. 结果一目了然:array2 instanceof Array 返回 false,而 Array.isArray(array2) 仍返回 true。

正如原片段所总结的:instanceof 在处理 iframe 场景时失效,而 Array.isArray() 无论数组以何种方式实例化,都能产生正确结果。

同样的陷阱也会出现在 window.open() 打开的新窗口、Web Worker、SharedWorker 等拥有独立 realm 的环境中,甚至在不同标签页之间传递数据时也可能遇到。凡是从"外部"获得的数据,只要它可能来自另一个 realm,instanceof Array 就不可信任。

instanceof 为什么会跨 realm 失效

从原理层面看,instanceof 运算符的行为等价于沿值的原型链逐级向上查找,判断是否存在目标构造器的 prototype 对象:

value instanceof Array
// 等价于:沿 value.__proto__ 链查找,看是否存在 Array.prototype

问题在于 Array.prototype 是按 realm 隔离的:iframe 内数组的原型是 iframe 的 Array.prototype,而不是当前页面的 Array.prototype。因此当代码用当前全局的 Array 去执行 instanceof 检查时,原型链上找不到匹配的原型对象,结果自然为 false。

仓库中另一篇 primitive-instanceof 片段也从侧面印证了 instanceof 的局限性:它只能用于检查类实例,并且其行为可以通过 Symbol.hasInstance 定制。对数组这类"通用对象"而言,原型链检查本质上依赖"构造器与值来自同一 realm"这一前提,而这恰恰是跨 realm 场景中最容易违背的假设。

而 Array.isArray() 之所以稳定,是因为它的实现不依赖原型链比对,而是执行标准的内部判定过程(对参数执行 IsArray 抽象操作),直接返回布尔结果,与值来自哪个 realm 无关。

补充边界:Object.prototype.toString 也能识别数组

除了 Array.isArray(),还有一种与 realm 无关的识别方式:Object.prototype.toString.call() 会返回对象内部 [[Class]] 标识,对数组恒为 '[object Array]':

Object.prototype.toString.call([1, 2, 3]);        // '[object Array]'
Object.prototype.toString.call({ a: 1 });          // '[object Object]'
Object.prototype.toString.call('hello');           // '[object String]'

这一技巧在 30 seconds of code 的类型检查体系中同样被采用——complete-guide-to-js-type-checking 在检查 async 函数与 generator 函数时,正是借助 Object.prototype.toString.call() 比对 '[object AsyncFunction]' / '[object GeneratorFunction]'。它跨 realm 稳定,但对数组而言,Array.isArray() 语义更直白、可读性更好,因此仍是官方推荐的首选方案。

实践建议

综合 typecheck-array 片段及其在仓库中的地位,可以总结出以下实践准则:

  1. 一律优先使用 Array.isArray():无论是本地数组还是跨 realm 传入的数组,结果都可靠;代码意图也更清晰;
  2. 谨慎使用 instanceof Array:仅在明确"值必然来自当前 realm"(如自己 new 出来的数组、模块内部构造的数组)时安全,任何来自 iframe、Web Worker、跨窗口或外部库的数据都应避免使用;
  3. 类型检查体系中各司其职:正如 complete-guide-to-js-type-checking 所示,原始类型用 typeof,类实例用 instanceof,通用对象用 Object(obj) === obj 模式,而数组这一特殊对象交给 Array.isArray();
  4. 服务端环境同样适用:在 Node.js 中虽然不存在 iframe,但 vm 模块创建的上下文、原生模块与多 realm 交互场景下,同样建议使用 Array.isArray() 以保证健壮性。

仓库中的相关资源

该片段在仓库中的定位与配套资源如下,读者可继续深入:

  • 片段原文:typecheck-array.md,位于 content/snippets/js/s/,归属于 JavaScript 语言;
  • 类型检查总纲:complete-guide-to-js-type-checking.md,覆盖原始类型、对象、函数、纯对象、async/generator 函数等完整检查矩阵;
  • instanceof 边界探讨:primitive-instanceof.md,讲解 Symbol.hasInstance 定制行为;
  • 集合编排:array-methods.yaml,typecheck-array 与 array-map-vs-foreach、4-array-methods 等共同构成 "JavaScript Array Methods" 集合;
  • 路由映射:redirects.yaml,旧地址 /articles/s/js-typecheck-array 以 301 状态重定向至 /js/s/typecheck-array,便于内容长期稳定引用。

核心结论只有一句话:判断 JavaScript 数组,始终使用 Array.isArray();instanceof Array 只在你完全掌控数组来源时才安全。

登录后查看全文
30-seconds-of-code