сетер

Оператор set прив'язує властивість об'єкта до функції, яка буде викликана під час спроби присвоїти значення даній властивості.

Синтаксис

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

Параметри

prop

Ім'я властивості, котра має бути прив'язана до даної функції.

val

Псевдонім змінної зі значенням,  для якого виконується спроба присвоїти його властивості prop.

expression

Починаючи від ECMAScript 2015 можна також використовувати вираз (expression) для вираховування імені властивості, до якої буде прив'язана дана функція.

Опис

В JavaScript сетер можна використати для виконання функції під час здійснення спроби змінити певну властивість. Найчастіше сетери використовуються у поєднанні з ґетерами для створення одного виду псевдо-властивостей. Не можна  водночас мати сетера на властивості, яка містить фактичне значення.

Зауважте особливість використання синтаксису set:

Сетер можна усунути, використовуючи оператор delete.

Приклади

Надання значення сетерові під час ініціалізації нового об'єкта

Це надасть значення псевдо-властивості current об'єкта language,який під час присвоєння значення додасть його також у властивість log:

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

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

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

Зверніть увагу, що  властивість current не визначена, а будь-які спроби викликати її повернуть значення undefined.

Усування сетера за допомогою оператора delete

Якщо потрібно усунути сетер, це можна знобити помістивши оператор delete перед ним:

delete o.current;

Присвоєння сетера вже створеному об'єктові, використовуючи defineProperty

Щоби в будь-який час присвоїти сетер об'єктові, який вже існує, використовуйте Object.defineProperty().

var o = {a: 0};

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

o.b = 10; // Виконує сетер, який приписує 10 / 2 (5) властивості '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';      // виконати сетер
console.log(obj.baz); // "baz"

Специфікації

Сумісність з браузерами

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

SpiderMonkey-specific notes

• Starting with JavaScript 1.8.1, setters are no longer called when setting properties in object and array initializers.
• From SpiderMonkey 38 on, a setter with a rest parameter is a SyntaxError as per the ES2015 specification.

See also

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