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

CKTIS / JavaScript

Chave de propriedade calculada num literal de objeto

A sintaxe `[expressão]: valor` determina a chave de uma propriedade quando o objeto é criado. O resultado é uma cadeia de caracteres ou um símbolo.

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

Sintaxe

const obj = { [keyExpression]: valueExpression };
const withMethod = { [keyExpression]() {} };

No literal { [key]: value }, o JavaScript determina a chave a partir do valor de key. Em { key: value }, a chave é literalmente "key". Os parênteses retos também permitem dar nome a um método: { [key]() {} }. Fora do literal, obj[key] acede a uma propriedade, em vez de a definir no literal.

Sempre que o literal é avaliado, as definições são processadas da esquerda para a direita. Em [key]: value, o JavaScript avalia e converte a chave antes de avaliar o valor. Alterar posteriormente a variável key não muda o nome da propriedade. Se a avaliação ou a conversão da chave lançar uma exceção, a expressão do valor não é avaliada.

ToPropertyKey converte primeiro o resultado num valor primitivo, dando preferência a cadeias de caracteres. Mantém um Symbol inalterado e converte os restantes valores primitivos em cadeias de caracteres. Assim, [1] e "1" designam a mesma chave. Se duas definições de propriedades de dados produzirem a mesma chave, prevalece a última. Para ler uma propriedade cuja chave é um símbolo, usa o mesmo símbolo, não um símbolo novo com a mesma descrição.

{ ["__proto__"]: null } cria uma propriedade de dados própria e deixa o protótipo inalterado. Já { __proto__: null } e { "__proto__": null } definem o protótipo como null sem criar essa propriedade. Uma atribuição posterior a outro objeto pode ainda invocar um setter herdado. JSON não aceita nomes de propriedades calculados. A sintaxe está especificada no ECMAScript 2024; verifica a compatibilidade se o código se destinar a ambientes de execução mais antigos.

Exemplos

{
  const key = "score";
  const token = Symbol("score");
  const obj = {
    [key]: 10,
    key: 20,
    [token]: 30,
    [1]: 40,
    "1": 50,
    ["__proto__"]: null,
  };

  console.log(obj[key]);
  console.log(obj.key);
  console.log(obj[token]);
  console.log(obj[1]);
  console.log(obj["__proto__"] === null && Object.getPrototypeOf(obj) === Object.prototype);
}

Resultado

10
20
30
50
true

`obj[key]` devolve `10`, o valor da propriedade com a chave `"score"`, enquanto `obj.key` devolve `20`, o valor da propriedade com a chave literal `"key"`. O símbolo é uma chave distinta. A definição posterior `"1"` substitui `[1]`, e a última verificação confirma o valor de `__proto__` e que o protótipo não mudou.

Lições relacionadas

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

Fontes