Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Array — arrays de JavaScript

Array é o construtor integrado para arrays: coleções ordenadas de valores indexadas a partir de zero. Aprende a criar arrays, o que significa a propriedade length e em que difere uma posição vazia de um elemento cujo valor é undefined.

Versão: ECMAScript built-in: the Array constructor dates to the first edition (1997). Array literals were introduced in ES3 (1999), Array.isArray in ES5 (2009), and Array.of in ES2015. Verification in Node.js 24 does not establish browser support.

Sintaxe

[element1, element2]
new Array(length)
Array.of(element1, element2)
Array.isArray(value)

Array é o construtor integrado de arrays em ECMAScript, não uma API Web. Um array é um objeto com tratamento especial para os índices e para a propriedade length. Pode conter valores de tipos diferentes. O primeiro elemento tem o índice 0; um literal de array como [10, 20] é normalmente a forma mais clara de criar um.

Tem atenção ao argumento numérico: new Array(3) cria um array com length igual a 3, mas sem elementos nesses índices. Array.of(3) e [3] criam um elemento com o valor 3. Uma posição vazia não é o mesmo que um elemento existente cujo valor é undefined; no exemplo, 0 in sparse devolve false.

length não corresponde necessariamente ao número de elementos existentes. Uma escrita num índice mais elevado pode aumentá-lo e deixar posições vazias. Num array comum e modificável, reduzir length elimina os elementos cujos índices são maiores ou iguais ao novo comprimento. delete values[0] remove um elemento sem encurtar o array.

push() modifica o array. Por omissão, map() devolve um novo array com os resultados, mas um construtor personalizado selecionado através de Symbol.species pode fazer com que devolva um objeto já existente. Para cada índice que analisa, map() verifica se a propriedade correspondente existe no próprio array ou na sua cadeia de protótipos. Se o array herdar essa propriedade, map() chama a função de callback para esse índice mesmo que o array não tenha aí um elemento próprio. As cópias de arrays são superficiais: os objetos aninhados podem continuar a ser partilhados. Usa Array.isArray(value) para identificar arrays, porque typeof devolve "object" para estes.

Exemplos

const values = [10, 20];
values.push(30);
const doubled = values.map(value => value * 2);
const sparse = new Array(3);
const single = Array.of(3);
console.log(JSON.stringify(values));
console.log(JSON.stringify(doubled));
console.log(`${sparse.length},${0 in sparse}`);
console.log(JSON.stringify(single));
console.log(Array.isArray(values));

Resultado

[10,20,30]
[20,40,60]
3,false
[3]
true

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes