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