Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Object.isFrozen — sprawdzanie zamrożenia obiektu

Object.isFrozen(value) sprawdza, czy obiekt jest nierozszerzalny, jego własne właściwości są niekonfigurowalne, a właściwości danych także niezapisywalne. Nie zamraża obiektu i nie sprawdza rekurencyjnie 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.isFrozen(value)

Object.isFrozen(value) jest metodą statyczną zwracającą true, gdy obiekt nie pozwala dodawać własnych właściwości, wszystkie jego własne właściwości mają configurable: false, a własne właściwości danych dodatkowo mają writable: false. Sprawdzane są także klucze typu symbol i właściwości niewyliczalne, ale nie właściwości odziedziczone.

Metoda sprawdza stan, zamiast go zmieniać; do zamrażania służy Object.freeze. Samo Object.seal nie wystarcza, jeśli pozostają zapisywalne właściwości danych. Pusty obiekt po Object.preventExtensions jest jednak już zamrożony, ponieważ nie ma właściwości, które naruszałyby pozostałe warunki.

Wynik true nie oznacza głębokiej niezmienności. Obiekty przechowywane jako wartości właściwości mogą nadal się zmieniać. Właściwości akcesorowe mogą zachować settery, a gettery mogą zwracać zmienne wyniki; test nie wymaga ich usunięcia ani nie wywołuje getterów zwykłego obiektu.

Dla wartości prymitywnych, w tym null i undefined, aktualna specyfikacja przewiduje true. W przypadku Proxy sprawdzanie może uruchomić pułapki i zgłosić wyjątek, więc nie zawsze jest operacją pozbawioną skutków ubocznych.

Przykłady

const settings = { theme: { dark: false } };
console.log(Object.isFrozen(settings));
Object.freeze(settings);
console.log(Object.isFrozen(settings));
console.log(Object.isFrozen(settings.theme));
settings.theme.dark = true;
console.log(settings.theme.dark);
console.log(Object.isFrozen(Object.preventExtensions({})));
console.log(Object.isFrozen(null));

Wynik

false
true
false
true
true
true

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

Źródła