30 seconds of code:用 Array.isArray() 正确进行 JavaScript 数组类型检查
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 正常
逐步拆解这段代码的执行过程:
- 创建一个
iframe元素并挂载到document.body,使其拥有独立的窗口与 realm; - 通过
window.frames[window.frames.length - 1].Array取得 iframe 全局环境中的Array构造器; array1由当前页面的Array构造;array2由 iframe 的Array构造;- 结果一目了然:
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 片段及其在仓库中的地位,可以总结出以下实践准则:
- 一律优先使用
Array.isArray():无论是本地数组还是跨 realm 传入的数组,结果都可靠;代码意图也更清晰; - 谨慎使用
instanceof Array:仅在明确"值必然来自当前 realm"(如自己new出来的数组、模块内部构造的数组)时安全,任何来自 iframe、Web Worker、跨窗口或外部库的数据都应避免使用; - 类型检查体系中各司其职:正如 complete-guide-to-js-type-checking 所示,原始类型用
typeof,类实例用instanceof,通用对象用Object(obj) === obj模式,而数组这一特殊对象交给Array.isArray(); - 服务端环境同样适用:在 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 只在你完全掌控数组来源时才安全。