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

CKTIS / JavaScript

Comprimento e indexação de arrays em JavaScript

`length` define o intervalo de posições de um array, não o número de elementos presentes. Escrever num índice pode ampliar o array; encurtá-lo pode eliminar elementos.

Versão: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxe

a.length
 a[i]
 a[i] = value
 a.length = newLength
 delete a[i]
 Object.hasOwn(a, i)
 a.at(-1)

a.length é uma propriedade de dados própria de uma instância de Array, não um método nem uma propriedade estática. Os índices começam em 0. Se o comprimento não for zero, a.length - 1 indica a última posição, que pode estar vazia. O comprimento vai de 0 a 2 ** 32 - 1; o maior índice de um array é 2 ** 32 - 2.

a[1] e a["1"] referem-se à mesma chave de propriedade. a["01"], a[-1] e a[2 ** 32 - 1] usam chaves que não são índices de array, pelo que escrever nessas chaves não altera o comprimento. Já a.at(-1) consulta a última posição em relação ao comprimento e devolve undefined se este for zero.

Se uma escrita criar um elemento próprio no índice i >= a.length, o comprimento aumenta para i + 1 e as posições saltadas ficam vazias. Uma lacuna não é um elemento próprio com o valor undefined: uma leitura com parênteses retos pode encontrar uma propriedade herdada e devolve undefined se não existir nenhuma propriedade com essa chave. Object.hasOwn(a, i) verifica se a propriedade é própria; i in a verifica também a cadeia de protótipos.

Aumentar length não cria elementos. Reduzi-la elimina os elementos próprios com índices iguais ou superiores ao novo comprimento, começando pelo maior índice. Voltar a aumentar o comprimento não os recupera. Uma operação delete a[i] bem-sucedida não encurta o array.

Atribuir um número fora do intervalo permitido ou não inteiro a uma propriedade length que permite escrita lança RangeError. Um elemento não configurável pode impedir o encurtamento: o comprimento fica igual ao índice desse elemento mais um e as eliminações já feitas não são revertidas. Em modo estrito, esta falha de atribuição lança TypeError; fora desse modo, pode passar despercebida.

Exemplos

{
  const a = ["A", undefined];
  a[3] = "D";
  console.log(`${a.length} ${a[1]} ${a[2]}`);
  console.log(`${Object.hasOwn(a, 1)} ${Object.hasOwn(a, 2)}`);

  a[-1] = "label";
  console.log(`${a[-1]} ${a.at(-1)} ${a.length}`);

  a.length = 2;
  a.length = 4;
  console.log(`${a.length} ${Object.hasOwn(a, 3)} ${a[-1]}`);
}

Resultado

4 undefined undefined
true false
label D 4
4 false label

A leitura dos índices `1` e `2` devolve `undefined` em ambos os casos, mas só `1` corresponde a um elemento próprio. A chave `-1` contém `label`, enquanto `a.at(-1)` devolve `D`. Encurtar o array elimina `D`; voltar a aumentá-lo não recupera `D` nem afeta a propriedade `-1`.

Lições relacionadas

  • JavaScript · Lição 28 · Avançado · Versão: 4

Fontes