Как проверить, что значение — массив?
На этой странице
Надежный способ — Array.isArray(value). typeof [] === "object", поэтому typeof не отличает массив от объекта. instanceof Array не работает для массивов из другого realm (iframe, worker), а Array.isArray работает всегда.
Вопрос
Как проверить, является ли значение массивом? Почему typeof не подходит и чем Array.isArray лучше instanceof Array?
Array.isArray
Array.isArray([]); // true
Array.isArray([1, 2, 3]); // true
Array.isArray(new Array(3)); // true
Array.isArray({ length: 2 }); // false — псевдомассив
Array.isArray("abc"); // false
Array.isArray(arguments); // false
Array.isArray(document.querySelectorAll("li")); // false — NodeListПочему не typeof
typeof []; // "object"
typeof {}; // "object"
typeof null; // "object"Массив — специальный вид объекта, поэтому typeof его не различает.
Почему не instanceof
[] instanceof Array; // trueinstanceof проверяет цепочку прототипов. Массив, созданный в iframe или worker, имеет другой Array.prototype, и проверка вернет false:
const iframe = document.createElement("iframe");
document.body.append(iframe);
const ForeignArray = iframe.contentWindow.Array;
const arr = new ForeignArray(1, 2);
arr instanceof Array; // false
Array.isArray(arr); // trueКроме того, прототип можно подменить: Object.setPrototypeOf({}, Array.prototype) instanceof Array вернет true, хотя это не массив.
Другие способы (исторические)
Object.prototype.toString.call([]); // "[object Array]"Работает надежно, но читается хуже — так делали до ES5.
Проверка на «похожесть» на массив
Если функции подходит любой итерируемый объект, проверяйте не тип, а возможности:
const isIterable = (value) => value != null && typeof value[Symbol.iterator] === "function";
const toArray = (value) => Array.from(value); // NodeList, Set, arguments, строкаЧто важно помнить
Array.isArrayсчитает массивом иArray.prototype— это особенность спецификации.- Типизированные массивы (
Uint8Array) — неArray:Array.isArray(new Uint8Array())—false, для них естьArrayBuffer.isView(). - В TypeScript
Array.isArrayсужает тип доany[]— при необходимости уточняйте тип вручную. - Пустой массив truthy: проверка «массив непустой» —
Array.isArray(v) && v.length > 0.
Мини-шпаргалка
Array.isArray(value)— правильный способ.typeof []—"object".instanceof Arrayломается на других realm.- Псевдомассивы и NodeList — не массивы, преобразуйте через
Array.from.