Reflect

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

Reflect — встроенный объект с методами для выполнения стандартных операций над объектами: чтения, записи, удаления свойств и других действий. Его методы вызываются напрямую, например Reflect.set(). Reflect не является функцией или конструктором: вызовы Reflect() и new Reflect() недопустимы.

Для обычной работы с объектом достаточно obj.name, obj[key] = value и delete obj[key]. Переменный ключ тоже не требует Reflect: его уже поддерживают квадратные скобки. Методы Reflect полезны, когда нужно проверить результат операции, явно задать получателя this или передать стандартную операцию из обработчика Proxy.

Чем Reflect отличается от обычных операций со свойствами
Операция Обычная запись Что даёт 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 года.

Показать браузеры
Совместимостьjavascript.builtins.Reflect
ВозможностьКомпьютерыМобильные
ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung BrowserWebView AndroidWebView on iOS
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.

Методы Reflect
Имя Назначение
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
Имя Назначение
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
<!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 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
<!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 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
<!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 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
<!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 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().