--- title: Array.isArray() slug: Web/JavaScript/Reference/Global_Objects/Array/isArray translation_of: Web/JavaScript/Reference/Global_Objects/Array/isArray ---
{{JSRef("Global_Objects", "Array")}}

Sumário

O método Array.isArray() retorna true se um objeto é uma array, e false se não é.

Sintaxe

Array.isArray(obj)

Parâmetros

obj
O objeto a ser verificado.

Descrição

Se o objeto é um {{jsxref("Array")}}, retorna true(verdadeiro), caso contrário é retornado false(falso).

Veja o artigo “Determinando com absoluta precisão se um objeto em Javascript é ou não uma array” para mais detalhes.

Exemplos

// todas as chamadas conseguintes retornam true
Array.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 false
Array.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étodo Array.isArray() será criado, caso o browser não o disponibilize nativamente.

if (!Array.isArray) {
  Array.isArray = function(arg) {
    return Object.prototype.toString.call(arg) === '[object Array]';
  };
}

Especificações

Especificação Status Comentário
{{SpecName('ES5.1', '#sec-15.4.3.2', 'Array.isArray')}} {{Spec2('ES5.1')}} Definição Inicial. Implementado em JavaScript 1.8.5.
{{SpecName('ES6', '#sec-array.isarray', 'Array.isArray')}} {{Spec2('ES6')}}  

Compatibilidade com o Browser

{{CompatibilityTable}}
Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Suporte Básico {{CompatChrome("5")}} {{CompatGeckoDesktop("2.0")}} {{CompatIE("9")}} {{CompatOpera("10.5")}} {{CompatSafari("5")}}
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Suporte Básico {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatGeckoMobile("2.0")}} {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatVersionUnknown}}

Baseado na Tabela de Compatibilidade de Kangax.

Veja Também