База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Object.preventExtensions — предотвратяване на добавянето на нови свойства

Object.preventExtensions(obj) необратимо предотвратява добавянето на собствени свойства към обект и връща същия обект. Не замразява съществуващите стойности или вложените обекти.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

Object.preventExtensions(obj)

Object.preventExtensions(obj) прави обекта неразширяем: не могат да се добавят нови собствени свойства, включително свойства с ключове от тип symbol. Методът променя подадения обект и връща същата референция, а не копие. Използвайте Object.isExtensible(obj), за да проверите състоянието му. Операцията не може да бъде отменена.

При обикновен обект съществуващите свойства запазват своите дескриптори: на записваемите свойства все още могат да се присвояват стойности, а конфигурируемите свойства все още могат да се изтриват. Изтрито свойство не може да бъде добавено отново. Прототипът също не може да бъде заменен с друг; посочването на съществуващия прототип остава позволено.

Типизиран масив с фиксирана дължина, който използва ArrayBuffer с непроменяем размер, може да бъде направен неразширяем. Съществуващите му индексирани елементи обаче не могат да бъдат изтрити, въпреки че дескрипторите им посочват configurable: true.

Присвояване, което би създало ново собствено свойство, предизвиква TypeError в строг режим и обикновено се игнорира извън него. Object.defineProperty предизвиква TypeError, когато се използва за добавяне на свойство, независимо от режима. Самият метод също предизвиква TypeError, ако вътрешната операция откаже да предотврати разширяването, например заради капан на Proxy, който връща false. В текущия ECMAScript примитивните аргументи, включително null и undefined, се връщат без промяна.

Object.seal осигурява по-силна защита: задава configurable на false за всички собствени свойства, така че те не могат да бъдат изтрити. При запечатан обикновен обект атрибутът writable на записваемо свойство с данни все още може да се промени от true на false. При запечатан обект на пространството от имена на модул дескрипторите на свойствата, които съответстват на експортираните обвързвания, посочват writable: true, но обектът не допуска промяна на този атрибут на false. При обикновен обект Object.freeze освен това задава writable на false за всички собствени свойства с данни. При обект на пространството от имена на модул Object.freeze предизвиква TypeError, когато се опита да зададе writable на false за свойство, което съответства на експортирано обвързване. Ако това обвързване все още не е инициализирано, извличането на дескриптора на свойството може да предизвика ReferenceError още преди този опит. Нито една от тези операции не засяга рекурсивно вложените обекти. Това е API на езика ECMAScript, а не уеб API на браузъра; само стандартът не доказва поддръжка в конкретен браузър.

Примери

"use strict";
const item = { count: 1, temporary: true };
const result = Object.preventExtensions(item);
console.log(result === item);
console.log(Object.isExtensible(item));
item.count = 2;
console.log(item.count);
console.log(delete item.temporary);
try {
  item.extra = 3;
} catch (error) {
  console.log(error.name);
}
console.log(Object.hasOwn(item, "extra"));

Резултат

true
false
2
true
TypeError
false

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници