CKTIS / JavaScript
Object.isFrozen — provjera je li objekt zamrznut
Object.isFrozen(value) provjerava je li objekt neproširiv, jesu li njegova vlastita svojstva nekonfigurabilna i jesu li njegova podatkovna svojstva nezapisiva. Ne zamrzava objekt niti rekurzivno provjerava ugniježđene objekte.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
Object.isFrozen(value)Object.isFrozen(value) statička je metoda koja vraća true kada objektu nije moguće dodati vlastita svojstva, sva njegova vlastita svojstva imaju configurable: false, a njegova vlastita podatkovna svojstva imaju i writable: false. Uključeni su simbolički ključevi i neenumerabilna svojstva, ali ne i naslijeđena svojstva.
Metoda ispituje stanje umjesto da ga mijenja; za zamrzavanje objekta upotrijebite Object.freeze. Sam Object.seal nije dovoljan ako ostanu zapisiva podatkovna svojstva. Prazan je objekt, međutim, zamrznut nakon Object.preventExtensions jer nema svojstava koja krše preostale uvjete.
Rezultat true ne znači duboku nepromjenjivost. Objekti pohranjeni kao vrijednosti svojstava i dalje se mogu mijenjati. Pristupna svojstva mogu zadržati settere, a getteri mogu vraćati promjenjive rezultate; provjera ne zahtijeva njihovo uklanjanje niti poziva gettere običnog objekta.
Za primitivne vrijednosti, uključujući null i undefined, trenutačna specifikacija vraća true. Kod Proxy objekta provjera može aktivirati zamke i izazvati iznimku pa nije uvijek bez nuspojava.
Primjeri
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));Rezultat
false true false true true true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.