Array.isArray în JavaScript

Tablouri (array) ES5 (toate browserele moderne)

Verifică dacă o valoare este un tablou (array).

Sintaxă
Array.isArray(valoare)

Ce face Array.isArray

typeof returnează "object" atât pentru tablouri, cât și pentru obiecte, deci nu le poate deosebi. Array.isArray returnează true doar pentru tablouri adevărate.

Obiectele care doar seamănă cu un tablou (au length și indici), cum sunt NodeList sau arguments, dau false.

Parametri

Parametru Descriere
valoare Valoarea verificată.

Ce returnează

true sau false.

Exemple

Exemplul 1: Tablouri și alte valori

console.log(Array.isArray([1, 2, 3]));
console.log(Array.isArray([]));
console.log(Array.isArray({ length: 2 }));
console.log(Array.isArray("text"));
console.log(typeof [1, 2, 3]);

Rezultat

true
true
false
false
object

Exemplul 2: O funcție care acceptă o valoare sau o listă

function catreLista(valoare) {
  return Array.isArray(valoare) ? valoare : [valoare];
}

console.log(catreLista("Ana"));
console.log(catreLista(["Ana", "Mihai"]));

Rezultat

[ 'Ana' ]
[ 'Ana', 'Mihai' ]

Greșeli frecvente

  • Verifici un tablou cu typeof x === "object". Condiția este adevărată și pentru obiecte și pentru null.

Comenzi înrudite

  • typeof: Returnează tipul unei valori ca text: „string”, „number”, „boolean”, „object” etc.
  • Array.from: Creează un tablou nou din orice listă: text, Set, Map, NodeList sau un obiect cu length.
  • Array.of / Array(): Creează un tablou din valorile primite; diferența față de constructorul Array().