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

CKTIS / JavaScript

get — getter de propriedade

A sintaxe get define um getter: uma função executada quando uma propriedade é lida. Permite calcular um valor sem chamar um método com parênteses; get não é, por si só, uma palavra reservada.

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

const obj = { get propertyName() { return expression; } };

get name() { ... } define um getter num literal de objeto ou numa classe. A leitura de obj.name executa o seu corpo; não escrevas obj.name(), a menos que o valor devolvido seja uma função. Um getter não pode declarar parâmetros.

Aqui, get tem um significado contextual, mas não é uma palavra reservada: const get = 1 é válido. name é uma propriedade de acesso: o seu descritor contém a função getter, não o valor que esta devolve.

Cada leitura volta a executar o getter: o resultado não é automaticamente guardado em cache. Não leias this.name dentro do getter de name, porque isso provoca recursão.

Sem um setter set correspondente, uma atribuição à propriedade lança um TypeError em modo estrito e é ignorada nos restantes casos. Isto não torna todo o objeto imutável.

Exemplos

"use strict";
const cart = {
  price: 12,
  quantity: 3,
  get total() {
    return this.price * this.quantity;
  }
};

console.log(cart.total);
cart.quantity = 4;
console.log(cart.total);

Resultado

36
48

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