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

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

Fontes