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

CKTIS / JavaScript

Definir um getter num literal de objeto

Com `get` num literal de objeto, a leitura de uma propriedade executa uma função e pode devolver um valor calculado a partir do estado atual do objeto.

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

Sintaxe

const obj = { get name() { /* body */ } };
const computed = { get [expression]() { /* body */ } };

Num literal de objeto, get name() { … } cria uma propriedade de acesso própria, enumerável e configurável. get [expression]() { … } permite usar uma chave calculada. A lista de parâmetros tem de estar vazia; caso contrário, a definição provoca um SyntaxError.

Ler obj.name chama o getter sem argumentos e devolve o seu resultado. Nesta leitura, this é obj, mesmo que o getter seja herdado. O resultado não fica automaticamente em cache. Em contraste, name() { … } define um método normal como valor de uma propriedade de dados: a leitura da propriedade não chama o método.

Um descritor de acesso usa get e set, não value nem writable. Object.getOwnPropertyDescriptor() permite inspecionar uma propriedade própria sem executar o seu getter. Sem um setter correspondente, a atribuição normal à propriedade é ignorada fora do modo estrito e lança um TypeError em modo estrito.

Para adicionar um getter a um objeto existente, usa Object.defineProperty() com um descritor que contenha get. Para uma propriedade nova, se enumerable e configurable forem omitidos, ficam ambos a false por predefinição, ao contrário do que acontece num literal de objeto. Um getter público não estático de uma classe encontra-se no protótipo da classe e não é enumerável.

Exemplos

{
  const item = {
    price: 10,
    quantity: 2,
    get total() {
      return this.price * this.quantity;
    },
  };

  console.log(item.total);
  item.quantity = 3;
  console.log(item.total);

  const descriptor = Object.getOwnPropertyDescriptor(item, "total");
  console.log(typeof descriptor.get);
  console.log(descriptor.enumerable);
  console.log(descriptor.configurable);
}

Resultado

20
30
function
true
true

A primeira leitura de `item.total` devolve `20`; depois de alterar `quantity`, a segunda devolve `30`. As últimas três linhas mostram que o descritor contém uma função getter e que a propriedade é enumerável e configurável.

Lições relacionadas

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

Fontes