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

CKTIS / JavaScript

Acesso a propriedades de objetos por chave calculada

Usa `obj[expr]` para ler ou atribuir um valor a uma propriedade escolhida por uma expressão, em vez de escrever um nome fixo após um ponto.

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

Sintaxe

obj[expr]             // read using a computed key
obj[expr] = value     // assign using a computed key
obj?.[expr]           // optional computed access
obj.name              // access the fixed string key "name"
({ [expr]: value })   // define a property in an object literal

Em obj[expr], o JavaScript avalia expr para escolher a propriedade a ler ou à qual atribuir um valor. obj.key designa sempre a chave de texto "key"; obj[key] usa o valor da variável key. Já { [expr]: value } define uma propriedade ao criar um objeto, em vez de a ler num objeto existente.

ToPropertyKey converte primeiro o valor da chave num valor primitivo. Se o resultado for um Symbol, mantém-no; caso contrário, converte-o numa cadeia de caracteres. Assim, obj[1] e obj["1"] referem-se à mesma propriedade. Os parênteses retos aceitam cadeias de caracteres com espaços, mas obj["#secret"] não acede ao campo privado de classe #secret.

Num objeto comum, uma leitura pode encontrar uma propriedade herdada ou chamar um getter. Se a propriedade não existir em toda a cadeia de protótipos, a leitura devolve undefined, tal como para uma propriedade com o valor undefined. Usa Object.hasOwn(obj, key) para verificar se a propriedade pertence diretamente ao objeto. Antes de leres ou escreveres com uma chave de origem não fiável, confirma que consta de uma lista de chaves permitidas; Object.hasOwn não substitui essa verificação.

Uma leitura normal sobre null ou undefined lança um TypeError se não ocorrer outro erro antes. Com esses valores de base, obj?.[expr] devolve undefined sem avaliar expr. Não interceta erros de getters nem pode servir de destino de uma atribuição. Trata-se de sintaxe JavaScript, não de uma API do DOM; confirma o suporte de ?. e Object.hasOwn em ambientes de execução mais antigos.

Exemplos

{
  const key = "display count";
  const tag = Symbol("status");
  const obj = { key: 0, [key]: 2, [tag]: "ready" };

  obj[key] = obj[key] + 1;
  console.log(obj[key]);
  console.log(obj.key);
  console.log(obj[tag]);

  const absent = null;
  console.log(String(absent?.[key]));
}

Resultado

3
0
ready
undefined

`obj[key]` passa de `2` para `3`, mas `obj.key` continua a valer `0`. `obj[tag]` lê `ready` através de uma chave do tipo `Symbol`, e o acesso opcional sobre `null` devolve `undefined`.

Lições relacionadas

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

Fontes