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

CKTIS / JavaScript

Acesso a propriedades através de uma chave calculada

A notação com parênteses retos `obj[expr]` seleciona uma propriedade a partir do valor de uma expressão. Permite ler e escrever propriedades e chamar métodos cujas chaves são determinadas em tempo de execução.

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

Sintaxe

object[expression]
object[expression] = value
object[expression](...args)
object?.[expression]

Em obj[expr], o valor de expr determina a chave da propriedade. obj.key usa sempre a cadeia de caracteres "key", enquanto obj[key] usa o valor da variável key. Os parênteses retos também permitem chaves com espaços. Em { [expr]: value }, indicam um nome de propriedade calculado: define-se uma propriedade num literal de objeto, em vez de a ler de um objeto existente.

ToPropertyKey converte o valor da chave num valor primitivo. Se este 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. A conversão de um objeto usado como chave pode executar código e lançar uma exceção.

Uma leitura normal pode percorrer a cadeia de protótipos e invocar um getter. Uma propriedade ausente dá undefined, mas uma propriedade existente também pode dar undefined. Object.hasOwn(obj, key) verifica se a propriedade pertence diretamente ao objeto. obj[key] = value segue as regras normais de atribuição e uma chamada direta obj[key]() tem obj como recetor, tal como obj.method().

Ler diretamente de null ou undefined lança um TypeError. Com um desses valores como base, obj?.[expr] devolve undefined sem avaliar expr; esta forma não pode ser o destino de uma atribuição. O acesso com parênteses retos é sintaxe ECMAScript, não uma API do navegador. Confirma que o ambiente de destino suporta ?. e Object.hasOwn.

Os parênteses retos não validam chaves externas. Antes de ler ou escrever com base em dados não fiáveis, limita as chaves a uma lista explícita de valores permitidos. Object.hasOwn, por si só, não verifica permissões.

Exemplos

{
  const key = "total points";
  const token = Symbol("bonus");
  const scores = { [key]: 7, [token]: 2, "1": "first" };

  console.log(`before: ${scores[key]}`);
  scores[key] = 9;
  console.log(`after: ${scores[key]}`);
  console.log(`literal key: ${scores.key}`);
  console.log(`symbol key: ${scores[token]}`);
  console.log(`numeric key: ${scores[1]}`);

  let evaluations = 0;
  const missing = null;
  console.log(`optional: ${missing?.[evaluations++]}`);
  console.log(`evaluations: ${evaluations}`);
}

Resultado

before: 7
after: 9
literal key: undefined
symbol key: 2
numeric key: first
optional: undefined
evaluations: 0

O exemplo altera o valor associado a uma chave com um espaço e mostra que `scores.key` procura a chave literal `"key"`. O último acesso não avalia `evaluations++`, pelo que o contador se mantém em `0`.

Lições relacionadas

  • JavaScript · Lição 24 · Avançado · Versão: 4
  • JavaScript · Lição 25 · Avançado · Versão: 4
  • JavaScript · Lição 29 · Avançado · Versão: 4

Fontes