CKTIS / JavaScript
Array.isArray: betrouwbare arraydetectie
Array.isArray controleert het interne Array-merk en gokt niet op basis van prototype, constructor of objectvorm.
Versie: ECMAScript 2026 draft; example target: Node.js 24.22.2
Syntax
Array.isArray(value)Array.isArray(value) retourneert alleen true voor een object met het interne Array-merk, ook voor subklassen en arrays uit een andere realm. Voor array-achtige objecten, arguments en typed arrays is het false, zonder coercie.
Dit is betrouwbaarder dan value instanceof Array, dat tussen vensters of iframes kan falen. Een gewone proxy volgt zijn arraydoel; een ingetrokken proxy kan TypeError werpen.
De functie ontvangt de waarde zelf en retourneert een boolean. Het voorbeeld onderscheidt een echte subklasse van een typed array en een object dat slechts op een array lijkt.
Voorbeelden
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}));Resultaat
true false false