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

CKTIS / JavaScript

Chaves calculadas de propriedades e métodos

Os parênteses retos numa definição de propriedade ou método permitem que uma expressão determine a respetiva chave. A chave é definida quando o objeto é criado; alterar mais tarde a variável usada na expressão não muda o nome da propriedade.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

({ [keyExpression]: value, [methodKeyExpression](parameters) { /* body */ } })

Num literal de objeto, [expression]: value avalia a expressão e usa o resultado como chave da propriedade. A forma [expression](parameters) {} define um método com nome calculado, sem dois-pontos nem a palavra-chave function. Esta sintaxe para nomes de métodos também funciona em classes.

Para obter uma chave de propriedade, o JavaScript converte primeiro um objeto num valor primitivo. Se o valor obtido ou já primitivo for um símbolo, o JavaScript usa-o como chave sem o alterar; caso contrário, converte-o numa cadeia de caracteres. Por exemplo, [1] e ["1"] identificam a mesma chave, ao passo que um objeto padrão que encapsula um símbolo dá como chave o próprio símbolo, não uma cadeia de caracteres. Num literal de objeto, a expressão da chave é avaliada quando o objeto é criado, e não em cada leitura.

Distingue a definição { [key]: value } do acesso obj[key]. A forma { key: value } usa o nome literal key, e obj.key lê esse nome, não o valor da variável. Também são necessários parênteses retos para chamar um método cujo nome está guardado numa variável: obj[methodKey]().

A sintaxe data de ECMAScript 2015 e é amplamente suportada pelos navegadores modernos; não requer qualquer Web API. JSON não permite chaves calculadas nem métodos. Caso especial: ["__proto__"]: value cria uma propriedade própria normal, enquanto __proto__: value num literal de objeto é sintaxe para definir o protótipo.

Identificadores de referência abrangidos por esta entrada: Computed property and method keys.

Exemplos

let key = "score";
const methodKey = "read";
const record = {
  [key]: 7,
  [methodKey]() {
    return this.score;
  },
};
key = "other";
console.log(record.score);
console.log(record[methodKey]());
console.log(record[key]);

Resultado

7
7
undefined

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes