setter

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨июль 2015 г.⁩.

Операторset связывает свойство объекта с функцией, которая будет вызвана при попытке установить это свойство.

Синтаксис

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

Параметры

prop: Имя свойства для привязки к заданной функции.

val: Псевдоним переменной, которая хранит значение, неудавшегося определенияprop.
expression: Начиная с ECMAScript 6, вы также можете использовать выражения для вычисляемого имя свойства для привязки к данной функции.

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

Обратите внимание на следующие моменты при работе с синтаксисомset:

Он может иметь идентификатор, который является либо числом, либо строкой;
Он должен иметь ровно один параметр (смотритеIncompatible ES5 change: literal getter and setter functions must now have exactly zero or one arguments для более подробной информации);
Он не должен объявляться в литерале объекта, с другим набором или вводом данных для того же самого свойства.({ set x(v) { }, set x(v) { } } и{ x: ..., set x(v) { } } запрещены)

Сеттер может быть удалён операторомdelete.

Примеры

Определение сеттера при инициализации новых объектов

Это позволит определить псевдо-параметрcurrent объектаo, который задаёт значение, обновляющее значениеlog:

var o = {  set current(str) {    this.log[this.log.length] = str;  },  log: [],};

обратите внимание, что current не определён и любые попытки доступа к нему вернутundefined.

Удаление сеттера оператором`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"