--- title: Array.isArray() slug: Web/JavaScript/Reference/Global_Objects/Array/isArray translation_of: Web/JavaScript/Reference/Global_Objects/Array/isArray ---
O método Array.isArray()
retorna true
se um objeto é uma array, e false
se não é.
Array.isArray(obj)
obj
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.
// 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 });
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çã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')}} |
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.