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

CKTIS / JavaScript

Chaves calculadas de métodos em literais de objeto

Num literal de objeto, `[expr](...) { ... }` define um método cuja chave é determinada por uma expressão. A chave é uma cadeia de caracteres ou um símbolo.

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

Sintaxe

const obj = { [expression](parameter) { /* method body */ } };
obj[key](argument);

Num literal de objeto, [expr](...) { ... } define um método com a chave determinada pela expressão expr. Sem parênteses retos, key() { ... } usa sempre a chave literal "key", independentemente do valor de uma variável com esse nome.

A expressão é avaliada sempre que o literal é avaliado, não sempre que o método é chamado. Para obter a chave, o JavaScript converte o resultado num valor primitivo, se necessário, mantém os símbolos inalterados e converte os restantes valores primitivos em cadeias de caracteres. Por exemplo, 1 torna-se "1". Se a avaliação ou a conversão lançar uma exceção, a criação do objeto é interrompida. Alterar mais tarde uma variável usada para calcular a chave não muda o nome da propriedade existente.

Em obj[key](...), os parênteses retos servem para aceder à propriedade. Ao chamar o método desta forma, this dentro do método é obj. Se o acesso devolver um valor não invocável, por exemplo porque a propriedade não existe, a chamada lança um TypeError.

Um método normal definido desta forma é uma propriedade própria e enumerável do objeto. Se duas definições de métodos normais no mesmo literal produzirem a mesma chave, a última substitui a anterior. Listas de parâmetros diferentes não criam sobrecargas.

Exemplos

const key = "say" + "Hi";
const loud = Symbol("loud");
const obj = {
  label: "Ada",
  [key]() {
    return "Hi, " + this.label;
  },
  [loud]() {
    return this.label.toUpperCase();
  },
};

console.log(obj[key]());
console.log(obj[loud]());

Resultado

Hi, Ada
ADA

`[key]` define um método com a chave textual `"sayHi"`, enquanto `[loud]` usa um valor do tipo `Symbol`. Ambas as chamadas leem `label` de `obj` através de `this`.

Lições relacionadas

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

Fontes