CKTIS / JavaScript
Array.isArray: riconoscimento affidabile degli array
Array.isArray controlla il marchio interno Array senza dedurlo da prototipo, costruttore o forma dell’oggetto.
Versione: ECMAScript 2026 draft; example target: Node.js 24.22.2
Sintassi
Array.isArray(value)Array.isArray(value) restituisce true solo per oggetti con il marchio interno Array, incluse sottoclassi e array di un altro realm. Restituisce false per oggetti array-like, arguments e typed array, senza conversione.
È più affidabile di value instanceof Array, che può fallire tra finestre o iframe. Un proxy normale segue l’array di destinazione; un proxy revocato può generare TypeError.
La funzione riceve direttamente il valore e restituisce un booleano. L’esempio distingue una sottoclasse reale da un typed array e da un oggetto solo simile a un array.
Esempi
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}));Risultato
true false false