CKTIS / JavaScript
Comprimento e indexação de arrays em JavaScript
`length` define o limite dos índices de um array, sem contar os elementos. Uma escrita pode alterar esse limite, e uma posição vazia não equivale a `undefined`.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
a.length; a[i]; a[i] = value; a.length = n; delete a[i]; Object.hasOwn(a, i); a.at(i);Os índices de um array começam em zero. a.length é uma propriedade própria, gravável por predefinição, mas não configurável. O seu valor é um inteiro de 0 a 2 ** 32 - 1. É o limite superior exclusivo dos índices dos elementos próprios, não a sua contagem. Em contraste, Array.length indica o número de parâmetros esperados pela função construtora, não o comprimento de um array.
Os parênteses retos dão acesso a propriedades: a[1] e a["1"] usam a mesma chave. Os índices são as representações decimais canónicas dos inteiros de 0 a 2 ** 32 - 2. Chaves como "01", "-1" e "4294967295" não são índices e não afetam o comprimento. a[-1] procura a propriedade "-1"; a.at(-1) lê a última posição de um array não vazio. Se o índice calculado estiver fora dos limites, at() devolve undefined sem procurar essa propriedade.
Criar um elemento próprio num índice i >= a.length aumenta o comprimento para i + 1. As posições saltadas ficam vazias. Uma posição vazia não tem propriedade própria; a leitura devolve undefined, salvo se houver um valor herdado. Object.hasOwn(a, i) distingue uma posição vazia de um elemento próprio com o valor undefined. Se delete a[i] for bem-sucedido, elimina o elemento sem encurtar o array.
Aumentar length acrescenta posições vazias; reduzi-lo elimina os elementos próprios a partir do novo limite. Se length for gravável, atribuir-lhe um valor do tipo Number que não seja inteiro ou esteja fora do intervalo permitido lança RangeError. Em contrapartida, atribuir-lhe um valor do tipo BigInt lança TypeError durante a conversão, antes de se verificar o intervalo. Um elemento não configurável pode impedir o truncamento: os elementos com índices superiores podem já ter sido eliminados, e o comprimento fica no índice que bloqueou a operação mais um. Em modo estrito, essa atribuição falhada lança TypeError.
Exemplos
{
const a = ["A"];
a[3] = "D";
a[2] = undefined;
a[-1] = "tag";
console.log(`length: ${a.length}`);
console.log(`1: ${a[1]}, own: ${Object.hasOwn(a, 1)}`);
console.log(`2: ${a[2]}, own: ${Object.hasOwn(a, 2)}`);
console.log(`[-1]: ${a[-1]}, at(-1): ${a.at(-1)}`);
a.length = 1;
a.length = 4;
console.log(`length: ${a.length}, own 3: ${Object.hasOwn(a, 3)}, [-1]: ${a[-1]}`);
}Resultado
length: 4 1: undefined, own: false 2: undefined, own: true [-1]: tag, at(-1): D length: 4, own 3: false, [-1]: tag
A leitura de `1` e de `2` dá `undefined`, mas só `2` é um elemento próprio. Voltar a aumentar o comprimento não recupera o elemento `3`; a propriedade `"-1"` mantém-se.
Lições relacionadas
- JavaScript · Lição 41 · Avançado · Versão: 4