Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Array.isArray: pewne rozpoznanie tablicy

Array.isArray wykonuje wewnętrzny test marki Array bez zgadywania po prototypie, konstruktorze ani kształcie obiektu.

Wersja: ECMAScript 2026 draft; example target: Node.js 24.22.2

Składnia

Array.isArray(value)

Array.isArray(value) zwraca true tylko dla obiektu mającego wewnętrzną markę tablicy, w tym podklas Array i tablic z innego realm. Dla obiektów array-like, arguments oraz typed arrays zwraca false; nie wykonuje konwersji wartości.

To bezpieczniejsze niż value instanceof Array, które może zawieść między oknami lub iframe. Zwykły Proxy tablicy jest rozpoznawany przez sprawdzenie celu, lecz odwołanie do cofniętego proxy może zgłosić TypeError.

Funkcja przyjmuje dokładnie badaną wartość i zawsze zwraca boolean. Przykład odróżnia podklasę prawdziwej tablicy od typed array oraz obiektu tylko przypominającego tablicę.

Przykłady

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}));

Wynik

true
false
false

Źródła