Сводка
Метод Array.isArray()
возвращает true
, если объект является массивом и false
, если он массивом не является.
Синтаксис
Array.isArray(obj)
Параметры
obj
- Объект для проверки.
Возвращаемое значение
true
если объект является Array
; иначе, false
.
Описание
За подробностям обращайтесь к статье «Абсолютно точное определение того, является ли JavaScript-объект массивом или нет».
Примеры
// Все следующие вызовы вернут 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
, потому что он работает и с iframes
.
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] // Correctly checking for Array Array.isArray(arr); // true // Considered harmful, because doesn't work through iframes arr instanceof Array; // false
Полифилл
Выполнение следующего кода перед любым другим кодом создаст метод Array.isArray()
, если он ещё не реализован в браузере.
if (!Array.isArray) { Array.isArray = function(arg) { return Object.prototype.toString.call(arg) === '[object Array]'; }; }
Спецификации
Спецификация | Статус | Комментарии |
---|---|---|
ECMAScript 5.1 (ECMA-262) Определение 'Array.isArray' в этой спецификации. |
Стандарт | Изначальное определение. Реализована в JavaScript 1.8.5. |
ECMAScript 2015 (6th Edition, ECMA-262) Определение 'Array.isArray' в этой спецификации. |
Стандарт |
Совместимость с браузерами
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
Компьютеры | Мобильные | Server | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
isArray | Chrome Полная поддержка 5 | Edge Полная поддержка 12 | Firefox Полная поддержка 4 | IE Полная поддержка 9 | Opera Полная поддержка 10.5 | Safari Полная поддержка 5 | WebView Android Полная поддержка Да | Chrome Android Полная поддержка 18 | Firefox Android Полная поддержка 4 | Opera Android Полная поддержка Да | Safari iOS Полная поддержка Да | Samsung Internet Android Полная поддержка Да | nodejs Полная поддержка Да |
Легенда
- Полная поддержка
- Полная поддержка