Array.isArray()
BaselineWidely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Sumário
O métodoArray.isArray() retornatrue se um objeto é uma array, efalse se não é.
Sintaxe
Array.isArray(obj)
Parâmetros
objO objeto a ser verificado.
Descrição
Se o objeto é umArray, retornatrue(verdadeiro), caso contrário é retornadofalse(falso).
Veja o artigo"Determinando com absoluta precisão se um objeto em Javascript é ou não uma array" para mais detalhes.
Exemplos
js
// todas as chamadas conseguintes retornam trueArray.isArray([]);Array.isArray([1]);Array.isArray(new Array());// Pequeno detalhe: Array.prototype por si só é uma array:Array.isArray(Array.prototype);// todas as conseguintes retornam falseArray.isArray();Array.isArray({});Array.isArray(null);Array.isArray(undefined);Array.isArray(17);Array.isArray("Array");Array.isArray(true);Array.isArray(false);Array.isArray({ __proto__: Array.prototype });Polyfill
Executando o seguinte código antes de qualquer outro, o métodoArray.isArray() será criado, caso o browser não o disponibilize nativamente.
js
if (!Array.isArray) { Array.isArray = function (arg) { return Object.prototype.toString.call(arg) === "[object Array]"; };}Especificações
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-array.isarray |