Методhandler.set() является ловушкой для установки значения свойству.

Синтаксис

var p = new Proxy(target, {  set: function (target, property, value, receiver) {},});

Параметры

Следующие параметры передаются методуset() .this привязан к обработчику

target

Исходный объект, который проксируется.

property

Имя свойства, в которое устанавливается значениеvalue.

value

Значение, устанавливаемое в свойствоproperty.

receiver

Объект, которому первоначально было присвоено задание. Обычно это сам прокси. Но обработчикset() также может быть вызван косвенно, через цепочку прототипов или различными другими способами.Например, предположим, что скрипт выполняетobj.name = "jen", при этомobj не является прокси и не имеет собственного свойства.name, но имеет прокси в цепочке прототипов. Будет вызван обработчик проксиset() , аobj будет передан в качестве получателя.

Возвращаемые результаты

Методset должен возвращать boolean значение.

• Возвращаетtrue, если присвоение выполнено успешно.
• Если методset() возвращаетfalse, а присваивание произошло в коде строгого режима, то будет выброшенаTypeError.

Описание

Методhandler.set является ловушкой для установки значения свойству.

Перехват

Эта ловушка может перехватывать следующие операции:

• Установка значения свойству:proxy[foo] = bar andproxy.foo = bar
• Установка значения наследованному свойству:Object.create(proxy)[foo] = bar
• Reflect.set()

Инварианты

Если нарушены следующие инварианты, то proxy выброситTypeError:

• Невозможно изменить значение свойства так, чтобы оно отличалось от значения соответствующего свойства целевого объекта, если соответствующее свойство целевого объекта не является доступным для записи и не настраиваемым свойством данных.
• Невозможно установить значение свойства, если соответствующее свойство целевого объекта является неконфигурируемым свойством средства доступа, для которого в качестве атрибута [[Set]] указано значение undefined.
• В строгом режиме при возврате из обработчикаset() значенияfalse, будет выброшено исключениеTypeError.

Примеры

Следующий код перехватывает установку значения свойству.

var p = new Proxy(  {},  {    set: function (target, prop, value, receiver) {      target[prop] = value;      console.log("property set: " + prop + " = " + value);      return true;    },  },);console.log("a" in p); // falsep.a = 10; // "property set: a = 10"console.log("a" in p); // trueconsole.log(p.a); // 10

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

Совместимость с браузерами

Смотрите также

• Proxy
• handler
• Reflect.set()