Reflect.preventExtensions()

Статический метод Reflect.preventExtensions() похож на Object.preventExtensions(). Он запрещает добавление новых свойств в объект (т. е. предотвращает будущие расширения объекта).

Попробовать

const object = {};

console.log(Reflect.isExtensible(object));
// Expected output: true

Reflect.preventExtensions(object);

console.log(Reflect.isExtensible(object));
// Expected output: false

Синтаксис

Reflect.preventExtensions(target)

Параметры

target

Целевой объект, для которого нужно запретить расширения.

Возвращаемое значение

Значение Boolean, указывающее, был ли целевой объект успешно настроен на предотвращение расширений.

Исключения

TypeError

Выбрасывается, если target не является объектом.

Описание

Reflect.preventExtensions() предоставляет рефлексивную семантику предотвращения расширений объекта. Отличия от Object.preventExtensions():

• Reflect.preventExtensions() выбрасывает TypeError, если целевой объект не является объектом, в то время как Object.preventExtensions() всегда возвращает не-объекты без изменений.
• Reflect.preventExtensions() возвращает Boolean, указывающий, был ли целевой объект успешно настроен на предотвращение расширений, в то время как Object.preventExtensions() возвращает целевой объект.

Reflect.preventExtensions() вызывает [[PreventExtensions]] внутренний метод объекта объекта target.

Примеры

Использование Reflect.preventExtensions()

См. также Object.preventExtensions().

// Objects are extensible by default.
const empty = {};
Reflect.isExtensible(empty); // true

// … but that can be changed.
Reflect.preventExtensions(empty);
Reflect.isExtensible(empty); // false

Отличие от Object.preventExtensions()

Если аргумент target этого метода не является объектом (примитивом), то это вызовет TypeError. В случае с Object.preventExtensions(), не-объект target будет возвращен как есть, без каких-либо ошибок.

Reflect.preventExtensions(1);
// TypeError: 1 is not an object

Object.preventExtensions(1);
// 1

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

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

См. также

• Полифил Reflect.preventExtensions в core-js
• Reflect
• Object.preventExtensions()
• handler.preventExtensions()