setter

Składnia set wiąże właściwość obiektu z funkcją, która zostanie wywołana przy próbie przypisania wartości danej właściwości.

{set prop(val) { . . . }}
{set [expression](val) { . . . }}

prop

Nazwa właściwości wiązanej z określoną funkcją.

val

Zmienna przechowująca wartość przekazaną do przypisania do właściwości prop.

expression

Począwszy od ECMAScript 2015, można również użyć wyrażeń w celu połaczenia funkcji z nazwą właściwości, która jest obliczana.

Setter może być użyty do wywołania określonej funkcji przy każdej próbie przypisania wartości do danej właściwości. Settery są najczęściej używane razem z getterami żeby utworzyć rodzaj pseudo-właściwości. Nie ma możliwości jednoczesnego używania settera oraz faktycznej wartości przypisanej do danej właściwości.

Uwagi do składni set:

Setter może być usunięty przy użyciu operatora delete.

Poniższa składnia definiuje pseudo-właściwość current obiektu language, która podczas przypisania wartości aktualizuje tablicę log o tą wartość:

var language = {
  set current(name) {
    this.log.push(name);
  },
  log: []
}

language.current = 'EN';
console.log(language.log); // ['EN']

language.current = 'FA';
console.log(language.log); // ['EN', 'FA']

Zwróć uwagę, że właściwość current nie jest zdefiniowana i próby odczytu zwrócą undefined.

Setter może zostać usunięty przy użyciu delete:

delete o.current;

Aby zdefiniować setter dla istniejącego obiektu po jego uprzednim utworzeniu użyj Object.defineProperty() (en-US).

var o = {a: 0};

Object.defineProperty(o, 'b', { set: function(x) { this.a = x / 2; } });

o.b = 10; // Uruchamia setter, który przypisuje 10 / 2 (5) do właściwości 'a'
console.log(o.a) // 5

var expr = 'foo';

var obj = {
  baz: 'bar',
  set [expr](v) { this.baz = v; }
};

console.log(obj.baz); // "bar"
obj.foo = 'baz';      // uruchom setter
console.log(obj.baz); // "baz"

• getter
• delete
• Object.defineProperty() (en-US)
• __defineGetter__ (en-US)
• __defineSetter__ (en-US)
• Defining Getters and Setters in JavaScript Guide