Esta página foi traduzida do inglês pela comunidade.Saiba mais e junte-se à comunidade MDN Web Docs.
Array.isArray()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since julho de 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 |