CKTIS / JavaScript
Object.isFrozen — ověření, zda je objekt zmrazený
Object.isFrozen(value) ověřuje, zda objekt nelze rozšiřovat, jeho vlastní vlastnosti nejsou konfigurovatelné a jeho datové vlastnosti nejsou zapisovatelné. Objekt nezmrazí ani rekurzivně nekontroluje vnořené objekty.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
Object.isFrozen(value)Object.isFrozen(value) je statická metoda, která vrací true, když k objektu nelze přidávat vlastní vlastnosti, všechny jeho vlastní vlastnosti mají configurable: false a jeho vlastní datové vlastnosti mají navíc writable: false. Zahrnuty jsou symbolické klíče a neenumerovatelné vlastnosti, nikoli zděděné vlastnosti.
Metoda zkoumá stav, místo aby jej měnila; ke zmrazení objektu použijte Object.freeze. Samotné Object.seal nestačí, pokud zůstanou zapisovatelné datové vlastnosti. Prázdný objekt je však po Object.preventExtensions zmrazený, protože nemá vlastnosti, které by porušovaly zbývající podmínky.
Výsledek true neznamená hlubokou neměnnost. Objekty uložené jako hodnoty vlastností se mohou dál měnit. Přístupové vlastnosti si mohou ponechat settery a gettery mohou vracet proměnlivé výsledky; test nevyžaduje jejich odstranění ani nespouští gettery běžného objektu.
U primitivních hodnot, včetně null a undefined, vrací aktuální specifikace true. U Proxy může kontrola spustit pasti a vyvolat výjimku, takže nemusí být vždy bez vedlejších účinků.
Příklady
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));Výsledek
false true false true true true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.