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