Reflect

Reflect - это встроенный объект, который предоставляет методы для перехватывания JavaScript операций. Эти методы аналогичны методам proxy handler`ов. Reflect - это не функциональный, а простой объект, он не является сконструированным.

Описание

В отличие от большинства глобальных объектов, Reflect - это не конструктор. Вы не можете использовать его с оператором new или вызывать Reflect, как функцию. Все свойства и методы объекта Reflect являются статическими (так же, как и у объекта Math).

Методы

Объект Reflect обеспечивает работу статических функций, называющиеся так же, как методы proxy handler`а. Некоторые из этих методов - те же, что и соответствующие им методы класса Object.

Reflect.apply()
Вызывает целевую функцию с аргументами, переданными в параметре args. Смотрите также Function.prototype.apply().
Reflect.construct()
 Оператор new как функция. Аналогично new target(...args). Также предоставляет возможность определить другой прототип.
Reflect.defineProperty()
Похож на Object.defineProperty(). Возвращает Boolean.
Reflect.deleteProperty()
Оператор delete как функция. Аналогично delete target[name].
Reflect.enumerate()
Похож на цикл for...in. Возвращает итератор с собственными перечисляемыми и наследуемыми свойствами целевого объекта.
Reflect.get()
Функция, которая возвращает значение свойств.
Reflect.getOwnPropertyDescriptor() (en-US)
Аналогично Object.getOwnPropertyDescriptor(). Возвращает дескриптор указанного свойства если присутствует в объекте, иначе undefined.
Reflect.getPrototypeOf() (en-US)
Аналогично Object.getPrototypeOf().
Reflect.has() (en-US)
Оператор in как функция. Возвращает значение Boolean в зависимости от факта наличия собственного или наследованного свойства.
Reflect.isExtensible() (en-US)
Аналогично Object.isExtensible().
Reflect.ownKeys()
Возвращает массив строк с именами собственных (не наследованных) свойств.
Reflect.preventExtensions() (en-US)
Аналогично Object.preventExtensions(). Возвращает Boolean.
Reflect.set() (en-US)
Функция, присваивающая значения свойствам. Возвращает Boolean значение true при успешном выполнении.
Reflect.setPrototypeOf() (en-US)
Функция, присваивающая прототип целевому объекту.

Примеры

Проверка наличия конкретных свойств у объекта

const duck = {
  name: 'Maurice',
  color: 'white',
  greeting: function() {
    console.log(`Quaaaack! My name is ${this.name}`);
  }
}

Reflect.has(duck, 'color');
// true
Reflect.has(duck, 'haircut');
// false

Возврат собственных ключей объекта

Reflect.ownKeys(duck);
// [ "name", "color", "greeting" ]

Добавление нового свойства в объект

Reflect.set(duck, 'eyes', 'black');
// вернётся "true" если вызов успешен
// объект "duck" теперь содержит свойство "eyes" со значением "black"

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

Спецификация Статус Комментарий
ECMAScript 2015 (6th Edition, ECMA-262)
Определение 'Reflect' в этой спецификации.
Стандарт Изначальное определение.

Совместимость с браузерами

BCD tables only load in the browser

Смотрите также

  • Глобальный объект Proxy.
  • Объект handler.