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.