Array.isArray()
BaselineWidely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
El métodoArray.isArray() determina si el valor pasado es unArray.
js
Array.isArray([1, 2, 3]); // trueArray.isArray({ foo: 123 }); // falseArray.isArray("foobar"); // falseArray.isArray(undefined); // falseSintaxis
Array.isArray(obj)
Parámetros
objEl objeto a evaluar.
Valor de retorno
true si el objeto es unArray; en caso contrario,false.
Descripción
Si el objeto es unArray, devuelvetrue;false, en cualquier otro caso.
Vea el artículo"Determining with absolute accuracy whether or not a JavaScript object is an array" para más detalles.
Ejemplos
js
// las siguientes llamadas devuelven trueArray.isArray([]);Array.isArray([1]);Array.isArray(new Array());Array.isArray(new Array("a", "b", "c", "d"));Array.isArray(new Array(3));// Hecho poco conocido: Array.prototype es también un array:Array.isArray(Array.prototype);// todas las siguientes llamadas devuelven falseArray.isArray();Array.isArray({});Array.isArray(null);Array.isArray(undefined);Array.isArray(17);Array.isArray("Array");Array.isArray(true);Array.isArray(false);Array.isArray({ __proto__: Array.prototype });instanceof vsisArray
Al comprobar una instanciaArray,Array.isArray es más recomendado queinstanceof porque funciona a través deiframes.
js
var iframe = document.createElement("iframe");document.body.appendChild(iframe);xArray = window.frames[window.frames.length - 1].Array;var arr = new xArray(1, 2, 3); // [1,2,3]// Comprobando correctamente un ArrayArray.isArray(arr); // true// Considerado peligroso, porque no funciona a través de iframesarr instanceof Array; // falsePolyfill
Ejecutar el siguiente código antes de cualquier otro código creará unArray.isArray() si no está disponible de forma nativa.
js
if (!Array.isArray) { Array.isArray = function (arg) { return Object.prototype.toString.call(arg) === "[object Array]"; };}Especificaciones
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-array.isarray |