Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Object.isSealed — sprawdzanie zapieczętowania obiektu

Object.isSealed(value) sprawdza, czy obiekt jest nierozszerzalny i wszystkie jego własne właściwości są niekonfigurowalne. Nie oznacza to niezmienności wartości ani zapieczętowania obiektów zagnieżdżonych.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

Object.isSealed(value)

Object.isSealed(value) zwraca true, gdy obiekt jest nierozszerzalny, a każda jego własna właściwość ma configurable: false. Sprawdzenie obejmuje także właściwości niewyliczalne i klucze typu Symbol, ale nie właściwości odziedziczone. Metoda sprawdza stan; w przeciwieństwie do Object.seal nie nakłada tych ograniczeń.

Zapieczętowanie blokuje dodawanie i usuwanie własnych właściwości oraz zmiany zabronione przez ich niekonfigurowalność. Samo zapieczętowanie nie zmienia atrybutu writable. W zwykłym obiekcie nadal można przypisać nową wartość do zapisywalnej własnej właściwości danych. W obiektach egzotycznych writable: true nie gwarantuje jednak, że przypisanie się powiedzie. Na przykład zapieczętowany obiekt przestrzeni nazw modułu zgłasza writable: true dla eksportowanych wiązań, ale odrzuca próby przypisania im wartości. Object.isFrozen wymaga dodatkowo, aby własne właściwości danych nie były zapisywalne. Żadne z tych sprawdzeń nie jest rekurencyjne.

Samo Object.preventExtensions zwykle nie wystarcza, jeśli pozostają konfigurowalne właściwości. Pusty nierozszerzalny obiekt jest jednak zapieczętowany. W obecnym ECMAScript argumenty pierwotne, w tym null i undefined, dają true; nie oznacza to, że są obiektami.

Dla Proxy sprawdzenie może uruchomić pułapki i zgłosić wyjątek, więc nie zawsze jest pozbawionym skutków ubocznych odczytem. To API języka ECMAScript, nie przeglądarkowe Web API; specyfikacja języka nie stanowi tabeli obsługi przeglądarek.

Przykłady

const item = { count: 1, nested: { active: true } };
console.log(Object.isSealed(item));
Object.seal(item);
item.count = 2;
console.log(Object.isSealed(item));
console.log(Object.isFrozen(item));
console.log(item.count);
console.log(Object.isSealed(item.nested));
console.log(Object.isSealed(Object.preventExtensions({})));
console.log(Object.isSealed(null));

Wynik

false
true
false
2
false
true
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła