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

CKTIS / JavaScript

Sintaxe de indexação de arrays em JavaScript

Usa parênteses retos para ler e escrever elementos de um array a partir do índice 0. Um índice pode alterar `length`; uma posição vazia não equivale a um valor `undefined` guardado.

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

Sintaxe

array[indexExpression]
array[indexExpression] = value
delete array[indexExpression]

a[i] lê uma propriedade e a[i] = value escreve nessa propriedade. O JavaScript avalia a expressão i e converte o resultado numa chave de propriedade: uma cadeia de caracteres ou um Symbol. Os índices de um Array normal começam em zero: a[0] e a["0"] referem-se à mesma propriedade.

Um índice de array é a representação decimal habitual de um inteiro entre 0 e 2³² − 2, inclusive, sem zeros adicionais à esquerda. As chaves "01" e "-1" não são índices, pelo que escrever nessas propriedades não altera length. a[-1] procura a propriedade "-1". Para ler a última posição, usa a.at(-1) se o ambiente de execução suportar o método. Fora dos limites, at() devolve undefined sem procurar a propriedade no índice calculado.

A leitura com parênteses retos também percorre a cadeia de protótipos. Se a chave não existir em nenhum ponto da cadeia, o resultado é undefined, não um erro de limites. Usa Object.hasOwn(a, i) para distinguir uma posição vazia (sem elemento próprio nesse índice) de um elemento próprio com o valor undefined.

Se uma escrita criar um elemento próprio num índice igual ou superior a length, o novo comprimento é esse índice mais um. As posições saltadas ficam vazias se não tiverem elementos próprios. delete a[i] não desloca elementos nem reduz length, mesmo quando a eliminação é bem-sucedida.

Exemplos

{
  const a = ["A"];
  a["01"] = "label";
  a[-1] = "tag";
  console.log(`${a[0]} ${a["0"]} ${a["01"]} ${a.length}`);

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

  delete a[4];
  console.log(`${Object.hasOwn(a, 4)} ${a.length}`);
}

Resultado

A A label 1
tag E 5
undefined false undefined true
false 5

Compara `a[-1]` com `a.at(-1)`. A leitura das posições `1` e `3` devolve `undefined` em ambos os casos, mas só `3` corresponde a um elemento próprio. Eliminar o elemento `4` não altera `length`.

Lições relacionadas

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

Fontes