База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Array.isArray: надежно разпознаване на масив

Array.isArray проверява вътрешната марка Array, вместо да гадае по прототипа, конструктора или формата.

Версия: ECMAScript 2026 draft; example target: Node.js 24.22.2

Синтаксис

Array.isArray(value)

Array.isArray(value) връща true само за обект с вътрешна марка Array, включително подклас и масив от друг realm. За array-like обекти, arguments и typed arrays връща false без преобразуване.

По-надеждно е от value instanceof Array, което може да се провали между прозорци или iframe. Обикновен proxy следва целевия масив; отменен proxy може да хвърли TypeError.

Функцията приема самата стойност и връща boolean. Примерът различава истински подклас от typed array и обект, който само прилича на масив.

Примери

class List extends Array {}
console.log(Array.isArray(new List(1, 2)));
console.log(Array.isArray(new Uint8Array(2)));
console.log(Array.isArray({0: "a", length: 1}));

Резултат

true
false
false

Източници