O objetoArray do JavaScript é um objeto global usado na construção de 'arrays': objetos de alto nível semelhantes a listas.

[element0, element1, ..., elementN]new Array(element0, element1, ..., elementN)new Array(arrayLength)

element0, element1, ..., elementN

Um array JavaScript é inicializado com os elementos contém, exceto no caso onde um único argumento é passado para o construtor doArray e esse argumento é um número (veja o parâmetro arrayLength abaixo). Esse caso especial só se aplica para os arrays JavaScript criados com o construtorArray , e não para literais de array criados com a sintaxe de colchetes [].

arrayLength

Se o único argumento passado para o construtor doArray for um número inteiro entre 0 e 232-1 (inclusive), um novo array com o tamanho desse número é retornado. Se o argumento for qualquer outro número, uma exceçãoRangeError é lançada.

Arrays são objetos semelhantes a listas que vêm com uma série de métodos embutidos para realizar operações de travessia e mutação. Nem o tamanho de um array JavaScript nem os tipos de elementos são fixos. Já que o tamanho de um array pode ser alterado a qualquer momento e os dados podem ser armazenados em posições não contíguas, arrays JavaScript não tem a garantia de serem densos; isso depende de como o programador escolhe usá-los. De uma maneira geral, essas são características convenientes, mas, se esses recursos não são desejáveis para o seu caso em particular, você pode considerar usar arrays tipados.

Arrays não podem usar strings como índices (como em umarray associativo), devem ser usados números inteiros. Definir ou acessar não-inteiros usandonotação de colchetes (ou notação de ponto) não vai definir ou recuperar um elemento do array em si, mas sim definir ou acessar uma variável associada com acoleção de propriedades de objeto daquele array. As propriedades de objeto do array e a lista de elementos do array são separados, e as operações de travessia e mutação não podem ser aplicadas a essas propriedades nomeadas.

Arrays JavaScript começam com índice zero: o primeiro elemento de um array está na posição0 e o último elemento está na posição equivalente ao valor da propriedadelength (tamanho) menos 1.

var arr = ["este é o primeiro elemento", "este é o segundo elemento"];console.log(arr[0]); // exibe 'este é o primeiro elemento'console.log(arr[1]); // exibe 'este é o segundo elemento'console.log(arr[arr.length - 1]); // exibe 'este é o segundo elemento'

Elementos de um array são somente propriedades de objetos, da forma quetoString é uma propriedade. Contudo, note que tentando acessar o primeiro elemento de um array da seguinte forma causará um erro de sintaxe, pois o nome da propriedade é inválido:

console.log(arr.0); // um erro de sintaxe

Não há nada de especial a respeito de arrays JavaScript e suas propriedades que causam isso. As propriedades JavaScript que começam com um dígito não podem ser referenciadas com notação de ponto. Elas necesitam usar notação de colchetes para poderem ser acessadas. Por exemplo, se você tivesse um objeto com a propriedade "3d", também teria que ser referenciá-la usando notação de colchetes. Por exemplo:

var anos = [1950, 1960, 1970, 1980, 1990, 2000, 2010];console.log(anos.0); // um erro de sintaxeconsole.log(anos[0]); // funciona corretamente

renderer.3d.setTexture(model, 'personagem.png'); // um erro de sintaxerenderer['3d'].setTexture(model, 'personagem.png'); //funciona corretamente

Note que no exemplo3d,'3d' teve de ser colocado entre aspas. É possivel também colocar entre aspas os índices de arrays JavaScript (ou seja,years['2'] ao invés deyears[2]), contudo isto não é necessário. O valor 2 emyears[2] eventualmente será convertido a uma string pela engine do JavaScript através de uma conversão explicita com o métodotoString. E é por esta razão que'2' e'02' irão referenciar dois slots diferentes no objetoanos e o seguinte exemplo pode sertrue:

console.log(anos["2"] != anos["02"]);

De forma similar, propriedades de objeto que sejam palavras reservadas(!) só podem ser acessadas como strings em notação de colchetes:

var promessa = {  var: "texto",  array: [1, 2, 3, 4],};console.log(promessa["var"]);

As propriedadeslength e numéricas de um array Javascript são conectadas. Varios dos métodos javascript pré-definidos (por exemplo,join,slice,indexOf etc.) levam em conta o valor da propriedadelength de um array quando eles são chamados. Outros métodos (por exemplo,push,splice etc.) também resultam em uma atualização na propriedadelength do array.

var frutas = [];frutas.push("banana", "maça", "pêssego");console.log(frutas.length); // 3

Quando configurar uma propriedade num array Javascript em que a propriedade é um índice valido do array e este índice está fora do atual limite do array, o array irá crescer para um tamanho grande o suficiente para acomodar o elemento neste índice, e a engine irá atualizar a propriedadelength do array de acordo com isto:

frutas[5] = "manga";console.log(frutas[5]); // 'manga'console.log(Object.keys(frutas)); // ['0', '1', '2', '5']console.log(frutas.length); // 6

Configurar a propriedadelength diretamente, também resulta em um comportamento especial:

frutas.length = 10;console.log(Object.keys(frutas)); // ['0', '1', '2', '5']console.log(frutas.length); // 10

Diminuir o valor delength, entretanto, apaga elementos:

frutas.length = 2;console.log(Object.keys(frutas)); // ['0', '1']console.log(frutas.length); // 2

O resultado de uma comparação entre umaexpressão regular e uma string pode criar um array Javascript. Este array tem propriedades e elementos que disponibilizam informações sobre a comparação. Esse array é o valor de retorno dos métodosRegExp.exec,String.match, eString.replace. Para explicar melhor sobre estas propriedades e elementos, veja o seguinte exemplo e então consulte a tabela abaixo:

// Encontra um d seguido por um ou mais b's seguido por um d// Salva os b's encontrados e o d seguinte// Ignora caixa (maiúscula/minúscula)var minhaRegex = /d(b+)(d)/i;var meuArray = minhaRegex.exec("cdbBdbsbz");

As propriedades e elementos retornados desta comparação são os seguintes:

Array.length

Propriedade comprimento do construtorArray, cujo valor é 1.

get Array[@@species]

A função de construtor que é utilizada para criar objetos derivados.

Array.prototype

Permite a adição de propriedades para todos os objetos array.

Array.from()

Cria uma nova instância deArray a partir de um objeto semelhante ou iterável.

Array.isArray()

Retornatrue se a variável é um array efalse caso contrário.

Array.of()

Cria uma nova instância deArray com um número variável de argumentos, independentemente do número ou tipo dos argumentos.

Todas as instâncias deArray herdam deArray.prototype. O protótipo do construtorArray pode ser modificado de forma a afetar todas as instâncias deArray.

Métodos modificadores

Métodos de acesso

Métodos de iteração

Algumas vezes você poderá querer aplicar métodos de arrays para strings ou outros objetos parecidos com arrays (como emargumentos de funções). Ao fazer isto, você trata uma string como um array de caracteres (ou em outros casos onde trata-se não-arrays como um array). Por exemplo, para checar se cada caractere em uma varivávelstr é uma letra, você poderia escrever:

function isLetter(character) {  return character >= "a" && character <= "z";}if (Array.prototype.every.call(str, isLetter))  alert("A string '" + str + "' contém somente letras!");

Esta notação é um pouco despendiosa e o JavaScript 1.6 introduziu a seguinte abreviação genérica:

if (Array.every(isLetter, str))  alert("A string '" + str + "' contém somente letras!");

Generics também estão disponíveis emString.

Estes não são atualmente parte dos padrões ECMAScript (através do ES2015Array.from() pode se conseguir isto). A seguir segue uma adaptação para permitir o uso em todos os navegadores:

/*globals define*/// Assumes Array extras already present (one may use shims for these as well)(function () {  "use strict";  var i,    // We could also build the array of methods with the following, but the    //   getOwnPropertyNames() method is non-shimable:    // Object.getOwnPropertyNames(Array).filter(function (methodName) {return typeof Array[methodName] === 'function'});    methods = [      "join",      "reverse",      "sort",      "push",      "pop",      "shift",      "unshift",      "splice",      "concat",      "slice",      "indexOf",      "lastIndexOf",      "forEach",      "map",      "reduce",      "reduceRight",      "filter",      "some",      "every",      "isArray",    ],    methodCount = methods.length,    assignArrayGeneric = function (methodName) {      var method = Array.prototype[methodName];      Array[methodName] = function (arg1) {        return method.apply(arg1, Array.prototype.slice.call(arguments, 1));      };    };  for (i = 0; i < methodCount; i++) {    assignArrayGeneric(methods[i]);  }})();

O exemplo a seguir cria um array,msgArray, comlength 0, então atribui valores paramsgArray[0] emsgArray[99], trocando olength do array para 100.

var msgArray = new Array();msgArray[0] = "Hello";msgArray[99] = "world";if (msgArray.length == 100) console.log("O length é 100.");

O exemplo a seguir cria um tabuleiro de xadrez usando dois arrays bi-dimensionais de string. A primeira jogada é feita copiando o 'p' em 6,4 para 4,4. A posição antiga de 6,4 é colocada em branco.

var board = [  ["R", "N", "B", "Q", "K", "B", "N", "R"],  ["P", "P", "P", "P", "P", "P", "P", "P"],  [" ", " ", " ", " ", " ", " ", " ", " "],  [" ", " ", " ", " ", " ", " ", " ", " "],  [" ", " ", " ", " ", " ", " ", " ", " "],  [" ", " ", " ", " ", " ", " ", " ", " "],  ["p", "p", "p", "p", "p", "p", "p", "p"],  ["r", "n", "b", "q", "k", "b", "n", "r"],];console.log(board.join("\n") + "\n\n");// Fazendo o King's Pawn avançar 2board[4][4] = board[6][4];board[6][4] = " ";console.log(board.join("\n"));

Saída:

R,N,B,Q,K,B,N,RP,P,P,P,P,P,P,P , , , , , , , , , , , , , , , , , , , , , , , , , , , ,p,p,p,p,p,p,p,pr,n,b,q,k,b,n,rR,N,B,Q,K,B,N,RP,P,P,P,P,P,P,P , , , , , , , , , , , , , , , , , ,p, , , , , , , , , ,p,p,p,p, ,p,p,pr,n,b,q,k,b,n,r

values = [];for (var x = 0; x < 10; x++) {  values.push([2 ** x, 2 * x ** 2]);}console.table(values);

Saída:

0  1  01  2  22  4  83  8  184  16  325  32  506  64  727  128  988  256  1289  512  162

• "Indexing object properties" in JavaScript Guide: "Working with objects"
• New in JavaScript 1.7: Array comprehensions
• New in JavaScript 1.6: Array extras
• Draft: Typed Arrays