MDN wants to learn about developers like you: https://qsurvey.mozilla.com/s3/MDN-dev-survey

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

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
ECMAScript 5.1 (ECMA-262)
The definition of 'Array.isArray' in that specification.
Standard Definição Inicial. Implementado em JavaScript 1.8.5.
ECMAScript 6 (ECMA-262)
The definition of 'Array.isArray' in that specification.
Release Candidate  

Compatibilidade com o Browser

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Suporte Básico 5 4.0 (2.0) 9 10.5 5
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Suporte Básico (Yes) (Yes) 4.0 (2.0) (Yes) (Yes) (Yes)

Baseado na Tabela de Compatibilidade de Kangax.

Veja Também

Etiquetas do documento e colaboradores

 Colaboradores desta página: lotharthesavior, ZavarezeH
 Última atualização por: lotharthesavior,