Reflect.set()

Определение и применение

Reflect.set() выполняет операцию записи свойства и возвращает признак успеха. С ним удобно проверить отказ записи, например после Object.freeze(). Метод входит в объект Reflect.

Поддержка браузерами

Спецификация: ecma262

Поддерживается во всех основных браузерах с 2016 года.

Показать браузеры
Совместимостьjavascript.builtins.Reflect.set
ВозможностьКомпьютерыМобильные
ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung BrowserWebView AndroidWebView on iOS
set✓49✓12✓42✓36✓10✓49✓42✓36✓10✓5.0✓49✓10

поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31

Синтаксис

JavaScript
Reflect.set(target, key, value);
Reflect.set(target, key, value, receiver);
Параметры Reflect.set()
Параметр Назначение
target Объект, с которого начинается поиск свойства и его правил записи. Примитив не подходит.
key Строка или символ — ключ свойства. Другие значения преобразуются к ключу.
value Новое значение любого типа.
receiver Необязательный получатель записи. По умолчанию совпадает с target; при вызове сеттера становится его this.

Успех и отказ записи

Для обычного изменяемого объекта без отдельного receiver записывается или создаётся свойство target. Успех обозначается true. Неизменяемое свойство, геттер без сеттера или запрет добавления свойства могут дать false. Возвращаемое значение — не записанные данные.

Обычное присваивание возвращает правую часть, а при отказе записи его поведение зависит от строгого режима. Reflect.set() сохраняет результат false и в строгом режиме. Но это не универсальное подавление ошибок: исключение из сеттера или ловушки Proxy продолжает распространяться.

Отдельный получатель

Если указан receiver, поиск правил начинается в target, а обычное поле записывается у получателя. Сеттер получает receiver как this. При этом запреты записи остаются в силе; четвёртый аргумент не позволяет обойти неизменяемое свойство.

Исключения

Исключения Reflect.set()
Тип исключения Условие
TypeError target не является объектом; также возможна ошибка при нарушении инвариантов Proxy.
Другие исключения Преобразование ключа, сеттер или ловушка Proxy могут выбросить своё исключение.

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

ECMAScript: Reflect.set.

Примеры, попробуйте сами

Изменение цены и отказ после заморозки

Замените новую цену и запустите снова. После заморозки отказ возвращается как false, а прежняя цена сохраняется.

index.html
HTML
<!doctype html>
<html lang="ru">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <title>Изменение цены и отказ после заморозки</title>
  </head>
  <body>
    <p>Откройте консоль браузера, чтобы увидеть результат.</p>
    <script src="main.js"></script>
  </body>
</html>
main.js
JavaScript
'use strict'
const product = { price: 180 }
console.log(Reflect.set(product, 'price', 210), product.price)
Object.freeze(product)
console.log(Reflect.set(product, 'price', 250), product.price)

Запись у отдельного получателя

Первый объект задаёт исходное свойство, второй получает новое значение. Уберите четвёртый аргумент и проверьте, какой объект изменится.

index.html
HTML
<!doctype html>
<html lang="ru">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <title>Запись у отдельного получателя</title>
  </head>
  <body>
    <p>Откройте консоль браузера, чтобы увидеть результат.</p>
    <script src="main.js"></script>
  </body>
</html>
main.js
JavaScript
const defaults = { price: 180 }
const product = {}
console.log(Reflect.set(defaults, 'price', 210, product))
console.log(defaults.price, product.price)