Сводка
Метод Array.isArray() возвращает true, если объект является массивом и false, если он массивом не является.
Синтаксис
Array.isArray(obj)
Параметры
obj- Объект для проверки.
Описание
За подробностям обращайтесь к статье «Абсолютно точное определение того, является ли 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 });
Полифилл
Выполнение следующего кода перед любым другим кодом создаст метод 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' в этой спецификации. |
Стандарт |
Совместимость с браузерами
| Возможность | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| Базовая поддержка | 5 | 4.0 (2.0) | 9 | 10.5 | 5 |
| Возможность | Android | Chrome для Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| Базовая поддержка | (Да) | (Да) | 4.0 (2.0) | (Да) | (Да) | (Да) |
На основе таблицы совместимости Kangax.