handler.set()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since сентябрь 2016 г..

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

Синтаксис

js
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 and proxy.foo = bar
Установка значения наследованному свойству: Object.create(proxy)[foo] = bar
Reflect.set()

Инварианты

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

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

Примеры

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

js
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); // false

p.a = 10; // "property set: a = 10"
console.log("a" in p); // true
console.log(p.a); // 10

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 29 июн. 2026 г. by MDN contributors.

View this page on GitHub • Report a problem with this content

Стандартные встроенные объекты
Proxy/handler
Методы экземпляра
Наследование
Object/Function
Статические методы
Статические свойства
Методы экземпляра
Свойства экземпляра
1. Object.prototype.__proto__
2. Object.prototype.constructor
Похожие страницы
Proxy

handler.set()

In this article