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

CKTIS / JavaScript

set — definir um setter de propriedade

`set` define um setter: uma função chamada quando é atribuído um valor a uma propriedade. Faz parte da sintaxe dos acessores e não é uma palavra reservada em todos os contextos.

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

({ set property(value) { /* body */ } })
class Example { set property(value) { /* body */ } }

set property(value) { ... } define um setter num literal de objeto ou numa classe. A atribuição obj.property = value chama-o com o valor atribuído. set não é uma palavra reservada: fora desta sintaxe, pode ser um identificador comum.

Um setter tem de ter exatamente um parâmetro formal; não é permitido um parâmetro rest. Pode coexistir com um getter get para a mesma propriedade. Ler uma propriedade que só tem um setter devolve undefined.

Guarde o estado com outro nome: escrever this.property = value dentro do setter de property chama novamente esse mesmo setter e provoca recursão. O valor devolvido por um setter é ignorado; uma expressão de atribuição resulta no valor atribuído.

No exemplo, o setter guarda o dobro do número em _value, e o getter lê-o. O prefixo _ é apenas uma convenção e não garante privacidade.

Exemplos

const counter = {
  _value: 0,
  set value(next) {
    this._value = next * 2;
  },
  get value() {
    return this._value;
  }
};

const assigned = (counter.value = 4);
console.log(counter.value);
console.log(assigned);

Resultado

8
4

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