Reflect
Определение и применение
Reflect — встроенный объект с методами для выполнения стандартных операций над объектами: чтения, записи,
удаления свойств и других действий. Его методы вызываются напрямую, например
Reflect.set(). Reflect не является функцией или конструктором: вызовы Reflect() и
new Reflect() недопустимы.
Для обычной работы с объектом достаточно obj.name, obj[key] = value и
delete obj[key]. Переменный ключ тоже не требует Reflect: его уже поддерживают квадратные
скобки. Методы Reflect полезны, когда нужно проверить результат операции, явно задать получателя
this или передать стандартную операцию из обработчика Proxy.
| Операция | Обычная запись | Что даёт Reflect |
|---|---|---|
| Чтение | obj[key] возвращает значение; в геттере this равен obj. |
Reflect.get(obj, key) читает так же. Третий аргумент receiver позволяет вызвать
геттер с другим this, сохранив поиск свойства в obj и его прототипах.
|
| Запись |
Значение выражения obj[key] = value — присваиваемое значение. Если запись запрещена, в нестрогом
режиме она молча не выполняется, а в строгом возникает TypeError.
|
Reflect.set(obj, key, value) возвращает true при успехе или false при
отказе. Необязательный receiver задаёт this сеттера, а для обычного свойства —
объект, на котором выполняется запись с учётом дескрипторов.
|
| Удаление |
delete obj[key] уже возвращает boolean, но при запрете удаления в строгом режиме
выбрасывает TypeError.
|
Reflect.deleteProperty(obj, key) возвращает false при запрете удаления даже в
строгом режиме. Если собственного свойства нет, возвращается true.
|
Reflect соблюдает ограничения свойств: не позволяет перезаписать свойство с
writable: false или удалить его при configurable: false. Исключения из геттеров, сеттеров и
обработчиков Proxy по-прежнему передаются вызывающему коду.
Поддержка браузерами
Спецификация: ecma262
Поддерживается во всех основных браузерах с 2016 года.
| Возможность | Компьютеры | Мобильные | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
Reflect | 49 | 12 | 42 | 36 | 10 | 49 | 42 | 36 | 10 | 5.0 | 49 | 10 |
apply | 49 | 12 | 42 | 36 | 10 | 49 | 42 | 36 | 10 | 5.0 | 49 | 10 |
construct | 49 | 12 | 42 | 36 | 10 | 49 | 42 | 36 | 10 | 5.0 | 49 | 10 |
defineProperty | 49 | 12 | 42 | 36 | 10 | 49 | 42 | 36 | 10 | 5.0 | 49 | 10 |
deleteProperty | 49 | 12 | 42 | 36 | 10 | 49 | 42 | 36 | 10 | 5.0 | 49 | 10 |
get | 49 | 12 | 42 | 36 | 10 | 49 | 42 | 36 | 10 | 5.0 | 49 | 10 |
getOwnPropertyDescriptor | 49 | 12 | 42 | 36 | 10 | 49 | 42 | 36 | 10 | 5.0 | 49 | 10 |
getPrototypeOf | 49 | 12 | 42 | 36 | 10 | 49 | 42 | 36 | 10 | 5.0 | 49 | 10 |
has | 49 | 12 | 42 | 36 | 10 | 49 | 42 | 36 | 10 | 5.0 | 49 | 10 |
isExtensible | 49 | 12 | 42 | 36 | 10 | 49 | 42 | 36 | 10 | 5.0 | 49 | 10 |
ownKeys | 49 | 12 | 42 | 36 | 10 | 49 | 42 | 36 | 10 | 5.0 | 49 | 10 |
preventExtensions | 49 | 12 | 42 | 36 | 10 | 49 | 42 | 36 | 10 | 5.0 | 49 | 10 |
set | 49 | 12 | 42 | 36 | 10 | 49 | 42 | 36 | 10 | 5.0 | 49 | 10 |
setPrototypeOf | 49 | 12 | 42 | 36 | 10 | 49 | 42 | 36 | 10 | 5.0 | 49 | 10 |
поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31
Методы Reflect
В таблице перечислены собственные методы Reflect. target — объект операции; для вызова
функции и конструктора нужен соответствующий вызываемый или конструируемый объект. key — строковый или
символьный ключ. receiver по умолчанию совпадает с target.
| Имя | Назначение |
|---|---|
apply(target, thisArgument, argumentsList) |
Вызывает функцию с заданным this и списком аргументов; возвращает результат функции. |
construct(target, argumentsList, newTarget) |
Вызывает конструктор и возвращает созданный объект. Необязательный newTarget определяет контекст
создания.
|
defineProperty(target, key, descriptor) |
Определяет собственное свойство по дескриптору; возвращает признак успеха. |
deleteProperty(target, key) |
Удаляет собственное свойство, если это разрешено; возвращает true или false. |
get(target, key, receiver) |
Читает значение свойства, включая унаследованное. receiver задаёт this для геттера.
|
getOwnPropertyDescriptor(target, key) |
Возвращает дескриптор собственного свойства или undefined, если его нет. |
getPrototypeOf(target) |
Возвращает прототип объекта либо null. |
has(target, key) |
Проверяет наличие свойства с учётом цепочки прототипов; возвращает boolean. |
isExtensible(target) |
Возвращает boolean: разрешено ли добавлять свойства. |
ownKeys(target) |
Возвращает массив всех собственных строковых и символьных ключей, включая неперечислимые. |
preventExtensions(target) |
Запрещает добавление свойств; возвращает признак успеха. |
set(target, key, value, receiver)
|
Записывает свойство; возвращает true или false. receiver задаёт
получателя записи.
|
setPrototypeOf(target, prototype) |
Устанавливает прототип (объект либо null); возвращает признак успеха. |
Собственные свойства
| Имя | Назначение |
|---|---|
Reflect[Symbol.toStringTag] |
Строка "Reflect", используемая стандартным строковым представлением. Свойство не перечисляется и
не перезаписывается обычным присваиванием; его можно перенастроить.
|
Экземпляров Reflect и собственного свойства Reflect.prototype нет. Унаследованные методы
Object.prototype не входят в эту таблицу.
Результат операции и ошибка
Ряд методов изменения возвращает признак успеха. Это позволяет обработать отказ без зависимости от строгого режима.
Однако некорректные аргументы, пользовательские геттеры и сеттеры, а также ловушки
Proxy могут выбрасывать исключения. Reflect не превращает любую ошибку в false.
Методы Reflect требуют объект в target. Многие методы
Object
иначе обрабатывают примитивы или возвращают другие результаты. В частности, Reflect.has() учитывает
прототип, а
Object.hasOwn()
проверяет только собственное свойство.
Связь с Proxy
В обработчике Proxy можно передать операцию соответствующему методу Reflect, сохранив её
обычные правила и получателя. Например, в ловушке get(target, key, receiver) вызов
Reflect.get(target, key, receiver) сохраняет this геттера. При чтении через прокси это
позволяет перехватывать и обращения к другим свойствам внутри геттера. Если написать target[key], геттер
будет читать их напрямую из исходного объекта.
Вызов передают именно исходному target: Reflect.get(proxy, key) внутри ловушки того же
прокси снова вызовет её и может привести к бесконечной рекурсии. Сам Reflect работает и без
Proxy, как показывают примеры проверки записи и просмотра свойств ниже.
Спецификация
ECMAScript: The Reflect Object.
Примеры, попробуйте сами
Запись, чтение и удаление свойства
Поменяйте значение цены и ключ свойства. Проверка после удаления показывает, что объект действительно изменился.
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 product = { price: 180 }
console.log(Reflect.set(product, 'price', 210))
console.log(Reflect.get(product, 'price'))
console.log(Reflect.deleteProperty(product, 'price'))
console.log(Reflect.has(product, 'price'))
Нажмите , чтобы запустить пример.
Обновить настройки и узнать, что изменить нельзя
При сохранении настроек нужен результат для каждого поля. Поменяйте writable и configurable у version: сравните отказ записи и отказ удаления даже при включённом строгом режиме.
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 settings = { theme: 'light', draft: true }
Object.defineProperty(settings, 'version', {
value: 1,
writable: false,
configurable: false,
enumerable: true,
})
const changes = { theme: 'dark', version: 2 }
for (const [key, value] of Object.entries(changes)) {
const saved = Reflect.set(settings, key, value)
console.log(`${key}: ${saved ? 'сохранено' : 'запись запрещена'}`)
}
for (const key of ['draft', 'version']) {
const removed = Reflect.deleteProperty(settings, key)
console.log(`${key}: ${removed ? 'удаление разрешено' : 'удаление запрещено'}`)
}
console.log(JSON.stringify(settings)) // {"theme":"dark","version":1}
Нажмите , чтобы запустить пример.
Такой приём пригодится редактору настроек: по результату можно показать, какое поле осталось прежним. Здесь проверяются обычные свойства данных; исключение из пользовательского сеттера всё ещё нужно обрабатывать отдельно. Правила возврата результата описаны в MDN: Reflect.set() и Reflect.deleteProperty().
Увидеть, какие свойства читает вычисляемый геттер
Запустите расчёт стоимости корзины: журнал покажет total, price и quantity. Замените Reflect.get(target, key, receiver) на target[key] — сумма останется той же, но чтения внутри геттера исчезнут из журнала.
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 cart = {
price: 250,
quantity: 3,
get total() {
return this.price * this.quantity
},
}
const reads = new Set()
const trackedCart = new Proxy(cart, {
get(target, key, receiver) {
reads.add(key)
// this внутри геттера останется прокси: вложенные чтения тоже попадут сюда.
return Reflect.get(target, key, receiver)
},
})
console.log('Стоимость:', trackedCart.total) // 750
console.log('Прочитаны:', [...reads].join(', ')) // total, price, quantity
Нажмите , чтобы запустить пример.
Это основа для диагностики обращений и отслеживания зависимостей вычислений: важно увидеть, что итог зависит от цены и
количества. Пример только собирает прочитанные ключи, автоматического пересчёта в нём нет. Роль
receiver описана в
MDN: Reflect.get().
Найти скрытые свойства и не запустить геттер
Сравните Object.keys() и Reflect.ownKeys(): второй покажет ещё неперечислимое свойство и Symbol. Добавьте свой ключ или измените enumerable. Просмотр дескрипторов не вычисляет значение геттера.
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 source = Symbol('source')
let getterCalls = 0
const product = {
name: 'Чай',
[source]: 'catalog',
get label() {
getterCalls += 1
return this.name.toUpperCase()
},
}
Object.defineProperty(product, 'internalId', {
value: 42,
enumerable: false,
})
console.log('Object.keys:', Object.keys(product).join(', ')) // name, label
for (const key of Reflect.ownKeys(product)) {
const descriptor = Reflect.getOwnPropertyDescriptor(product, key)
// Читаем значение из дескриптора, чтобы не вызывать product[key].
const value = 'value' in descriptor ? descriptor.value : '[геттер]'
console.log(`${String(key)}: ${value}`)
}
// name: Чай; label: [геттер]; internalId: 42; Symbol(source): catalog
console.log('Вызовов геттера:', getterCalls) // 0
Нажмите , чтобы запустить пример.
Приём полезен для отладки объектов сторонней библиотеки: Object.keys() показывает не все собственные
ключи, а прямое чтение значений может запустить геттер с побочным эффектом. Для обычного объекта дескриптор позволяет
изучить свойство без его вызова; у Proxy сам запрос дескриптора может вызвать ловушку. Подробнее о
составе ключей —
MDN: Reflect.ownKeys().