Reflect.set()
Определение и применение
Reflect.set() выполняет операцию записи свойства и возвращает признак успеха. С ним удобно проверить
отказ записи, например после
Object.freeze(). Метод входит в объект
Reflect.
Поддержка браузерами
Спецификация: ecma262
Поддерживается во всех основных браузерах с 2016 года.
| Возможность | Компьютеры | Мобильные | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
set | 49 | 12 | 42 | 36 | 10 | 49 | 42 | 36 | 10 | 5.0 | 49 | 10 |
поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31
Синтаксис
Reflect.set(target, key, value);
Reflect.set(target, key, value, receiver);| Параметр | Назначение |
|---|---|
target |
Объект, с которого начинается поиск свойства и его правил записи. Примитив не подходит. |
key |
Строка или символ — ключ свойства. Другие значения преобразуются к ключу. |
value |
Новое значение любого типа. |
receiver |
Необязательный получатель записи. По умолчанию совпадает с target; при вызове сеттера становится
его this.
|
Успех и отказ записи
Для обычного изменяемого объекта без отдельного receiver записывается или создаётся свойство
target. Успех обозначается true. Неизменяемое свойство, геттер без сеттера или запрет
добавления свойства могут дать false. Возвращаемое значение — не записанные данные.
Обычное присваивание возвращает правую часть, а при отказе записи его поведение зависит от
строгого режима.
Reflect.set() сохраняет результат false и в строгом режиме. Но это не универсальное
подавление ошибок: исключение из сеттера или ловушки Proxy продолжает распространяться.
Отдельный получатель
Если указан receiver, поиск правил начинается в target, а обычное поле записывается у
получателя. Сеттер получает receiver как this. При этом запреты записи остаются в силе;
четвёртый аргумент не позволяет обойти неизменяемое свойство.
Исключения
| Тип исключения | Условие |
|---|---|
TypeError |
target не является объектом; также возможна ошибка при нарушении инвариантов Proxy.
|
Другие исключения |
Преобразование ключа, сеттер или ловушка Proxy могут выбросить своё исключение. |
Спецификация
Примеры, попробуйте сами
Изменение цены и отказ после заморозки
Замените новую цену и запустите снова. После заморозки отказ возвращается как false, а прежняя цена сохраняется.
index.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
'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 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
const defaults = { price: 180 }
const product = {}
console.log(Reflect.set(defaults, 'price', 210, product))
console.log(defaults.price, product.price)
Нажмите , чтобы запустить пример.