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

CKTIS / JavaScript

Propriedades abreviadas, métodos concisos e acesso com chaves calculadas

Distingue propriedades abreviadas e métodos concisos num literal de objeto da leitura, da escrita e da chamada com uma chave determinada em tempo de execução.

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

Sintaxe

const obj = {
  x,
  [key]: value,
  method(arg) { /* body */ },
  [methodKey](arg) { /* body */ },
};
obj.x;
obj[key];
obj[key] = value;
obj.method(arg);
obj[methodKey](arg);

Num literal de objeto, { x } é a forma abreviada de { x: x }. Cria uma propriedade de dados própria chamada "x" com o valor atual da variável x. Uma atribuição posterior à variável não altera a propriedade. Se a variável não existir, a avaliação do literal lança um ReferenceError.

method(arg) { … } define um método sem function. Ao contrário de method: function (arg) { … } com uma função normal, o método conciso não é um construtor (new obj.method() lança um TypeError) e pode usar super para procurar propriedades no protótipo do objeto em que foi definido. Em obj.method(arg) e obj[methodKey](arg), obj é o recetor this. Guardar o método numa variável não conserva esse recetor.

{ [key]: value } e { [methodKey](arg) { … } } calculam a chave quando o objeto é criado. obj[key] calcula-a a cada acesso, enquanto obj.key designa sempre a propriedade "key". As chaves são cadeias de caracteres ou valores Symbol; por exemplo, o número 1 torna-se "1". Os parênteses retos também permitem nomes que não podem ser escritos com a notação de ponto, como em obj["bonus-points"].

obj[key] lê uma propriedade e obj[key] = value atribui-lhe um valor. Numa pesquisa normal de propriedades, a leitura devolve undefined se a chave não existir no objeto nem na sua cadeia de protótipos. Se o próprio objeto ou um objeto da sua cadeia de protótipos for um Proxy, a sua armadilha get pode devolver outro valor mesmo que não exista nenhuma propriedade com essa chave. Aceder a uma propriedade de null ou undefined lança um TypeError. Antes do acesso dinâmico, verifica as chaves não fidedignas face a uma lista de chaves permitidas, sobretudo antes de escrever.

Num literal, { ["__proto__"]: value } cria uma propriedade de dados própria normal, ao passo que { __proto__: value } é uma sintaxe especial que define o protótipo se value for um objeto ou null. Estas formas fazem parte de ECMAScript 2024; a disponibilidade depende do ambiente de execução.

Exemplos

{
  const x = 2;
  const key = "bonus-points";
  const methodKey = Symbol("addBonus");
  const obj = {
    x,
    [key]: 3,
    total() {
      return this.x + this[key];
    },
    [methodKey](amount) {
      this[key] += amount;
      return this.total();
    },
  };

  console.log(obj.total());
  console.log(obj[methodKey](4));
  console.log(obj[key]);
  console.log(obj.key);
}

Resultado

5
9
7
undefined

`x` vale `2` e `"bonus-points"` começa em `3`. Chamar o método através da sua chave `Symbol` aumenta o bónus para `7` e devolve o total `9`. `obj.key` procura o nome literal `"key"`, pelo que devolve `undefined`.

Lições relacionadas

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

Fontes