JavaScript метод Object.preventExtensions()

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

JavaScript метод preventExtensions() позволяет сделать объект нерасширяемым (предотвращает добавление новых собственных (неунаследованных) свойств). При этом допускается как удаление, так и изменение свойств объекта, на котором был вызван метод.

Если в цепочке прототипов объекта на котором был вызван метод preventExtensions() содержится расширяемый объект, то в этом случае остается возможность добавить в нерасширяемый объект унаследованные свойства.

Сравнение подобных методов

Object: справочные сведения
Метод Объект становится нерасширяемым Атрибут configurable для каждого собственного (неунаследованного) свойства имеет значение false Атрибут writable для каждого собственного (неунаследованного) свойства имеет значение false
preventExtensions() Да Нет Нет
seal() Да Да Нет
freeze() Да Да Да

Поддержка браузерами

Спецификация: ecma262

Поддерживается во всех основных браузерах с 2015 года.

Показать браузеры
Совместимостьjavascript.builtins.Object.preventExtensions
ВозможностьКомпьютерыМобильные
ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung BrowserWebView AndroidWebView on iOS
preventExtensions✓6✓12✓4✓12✓5.1✓18✓4✓12✓5✓1.0✓4.4✓5
ES2015 behavior for non-object argument✓44✓12✓35✓31✓9✓44✓35✓32✓9✓4.0✓44✓9

поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31

JavaScript синтаксис

JavaScript
Object.preventExtensions( obj );

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

ECMAScript: Object.preventExtensions()

Значения параметров

Object: справочные сведения
Параметр Описание
obj Целевой объект, который необходимо сделать нерасширяемым. Обязательное значение.

Исключения

Object: справочные сведения
Тип исключения Описание
TypeError Примитивы, включая null и undefined, возвращаются без изменений. Операции с объектом могут выбросить TypeError, например при нарушении ограничений прокси.

Примеры, попробуйте сами

В примере «Запрет добавления новых свойств» показан результат вызова метода.

Запрет добавления новых свойств

Измените свойства исходного объекта и сравните результат до и после вызова метода.

index.html
HTML
<!doctype html>
<html lang="ru">
  <head>
    <meta charset="UTF-8" />
    <title>Запрет добавления новых свойств</title>
  </head>
  <body>
    <p>Результат выполнения выводится в консоль.</p>
  </body>
</html>
main.js
JavaScript
// инициализируем переменную, содержащую объект
let obj = {
    a: 1,
    b: 2,
    c: 3,
}
// проверяем является ли объект расширяемым
console.log(Object.isExtensible(obj)) // true

obj.d = 4 // добавляем свойство

// делаем объект нерасширяемым
Object.preventExtensions(obj)

obj.a = 100 // изменяем свойство
delete obj.c // удаляем свойство

console.log(obj) // {a: 100, b: 2, d: 4}

// пытаемся добавить свойство
obj.f = 5

console.log(obj) // {a: 100, b: 2, d: 4}

// проверяем является ли объект расширяемым
console.log(Object.isExtensible(obj)) // false

В этом примере мы инициализировали переменную, содержащую объект и с помощью метода isExtensible() мы проверяем является ли объект расширяемым. Получив подтверждение о том, что объект является расширяемым мы добавляем в него свойство d, и с помощью метода preventExtensions() делаем его нерасширяемым.

Далее мы изменяем свойство a объекта и удаляем свойство с, выводим содержимое объекта в консоль, и пытаемся добавить свойство f в объект. Затем снова выводим в консоль содержимое объекта, как вы можете заметить свойство f добавлено не было.

В заключении примера с помощью метода isExtensible() мы проверяем является ли наш объект расширяемым, в результате чего мы получаем значение false, которое свидетельствует о том, что наш объект является нерасширяемым.