JavaScript метод Object.preventExtensions()
Определение и применение
JavaScript метод preventExtensions() позволяет сделать объект нерасширяемым (предотвращает добавление
новых собственных (неунаследованных) свойств). При этом допускается как удаление, так и изменение свойств объекта, на
котором был вызван метод.
Если в цепочке прототипов объекта на котором был вызван метод preventExtensions() содержится расширяемый
объект, то в этом случае остается возможность добавить в нерасширяемый объект унаследованные свойства.
Сравнение подобных методов
| Метод | Объект становится нерасширяемым |
Атрибут configurable для каждого собственного (неунаследованного) свойства имеет значение
false
|
Атрибут writable для каждого собственного (неунаследованного) свойства имеет значение
false
|
|---|---|---|---|
preventExtensions() |
Да | Нет | Нет |
seal()
|
Да | Да | Нет |
freeze()
|
Да | Да | Да |
Поддержка браузерами
Спецификация: ecma262
Поддерживается во всех основных браузерах с 2015 года.
| Возможность | Компьютеры | Мобильные | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
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 синтаксис
Object.preventExtensions( obj );
Спецификация
ECMAScript: Object.preventExtensions()
Значения параметров
| Параметр | Описание |
|---|---|
obj |
Целевой объект, который необходимо сделать нерасширяемым. Обязательное значение. |
Исключения
| Тип исключения | Описание |
|---|---|
TypeError |
Примитивы, включая null и undefined, возвращаются без изменений. Операции с объектом
могут выбросить TypeError, например при нарушении ограничений прокси.
|
Примеры, попробуйте сами
В примере «Запрет добавления новых свойств» показан результат вызова метода.
Запрет добавления новых свойств
Измените свойства исходного объекта и сравните результат до и после вызова метода.
index.html
<html lang="ru">
<head>
<meta charset="UTF-8" />
<title>Запрет добавления новых свойств</title>
</head>
<body>
<p>Результат выполнения выводится в консоль.</p>
</body>
</html>
main.js
// инициализируем переменную, содержащую объект
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, которое
свидетельствует о том, что наш объект является нерасширяемым.