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