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