Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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

Fonti