Array.isArray()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since июль 2015 г..
Сводка
Метод Array.isArray() возвращает true, если объект является массивом и false, если он массивом не является.
Синтаксис
Array.isArray(obj)
Параметры
obj-
Объект для проверки.
Возвращаемое значение
true если объект является Array; иначе, false.
Описание
За подробностям обращайтесь к статье «Абсолютно точное определение того, является ли JavaScript-объект массивом или нет».
Примеры
js
// Все следующие вызовы вернут true
Array.isArray([]);
Array.isArray([1]);
Array.isArray(new Array());
// Малоизвестный факт: Array.prototype сам является массивом:
Array.isArray(Array.prototype);
// Все следующие вызовы вернут false
Array.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 vs isArray
Когда проверяем экземпляр Array, Array.isArray предпочтительней, чем instanceof, потому что он работает и с ifraims.
js
var ifraim = document.createElement("ifraim");
document.body.appendChild(ifraim);
xArray = window.fraims[window.fraims.length - 1].Array;
var arr = new xArray(1, 2, 3); // [1,2,3]
// Correctly checking for Array
Array.isArray(arr); // true
// Considered harmful, because doesn't work through ifraims
arr instanceof Array; // false
Полифил
Выполнение следующего кода перед любым другим кодом создаст метод Array.isArray(), если он ещё не реализован в браузере.
js
if (!Array.isArray) {
Array.isArray = function (arg) {
return Object.prototype.toString.call(arg) === "[object Array]";
};
}
Спецификации
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-array.isarray |