Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Array.isArray: deteção fiável de arrays

Array.isArray verifica a marca interna Array sem deduzir pelo protótipo, construtor ou forma do objeto.

Versão: ECMAScript 2026 draft; example target: Node.js 24.22.2

Sintaxe

Array.isArray(value)

Array.isArray(value) devolve true apenas para objetos com a marca interna Array, incluindo subclasses e arrays de outro realm. Devolve false para objetos array-like, arguments e typed arrays, sem converter a entrada.

É mais fiável que value instanceof Array, que pode falhar entre janelas ou iframes. Um proxy normal segue o array alvo; um proxy revogado pode lançar TypeError.

A função recebe diretamente o valor e devolve um booleano. O exemplo distingue uma subclasse verdadeira de um typed array e de um objeto apenas semelhante a array.

Exemplos

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}));

Resultado

true
false
false

Fontes