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