CKTIS / JavaScript
Object.isFrozen — kontrola, či je objekt zmrazený
Object.isFrozen(value) kontroluje, či objekt nie je rozšíriteľný, jeho vlastné vlastnosti nie sú konfigurovateľné a jeho dátové vlastnosti nie sú zapisovateľné. Objekt nezmrazí ani rekurzívne nekontroluje vnorené objekty.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
Object.isFrozen(value)Object.isFrozen(value) je statická metóda, ktorá vráti true, keď k objektu nemožno pridávať vlastné vlastnosti, všetky jeho vlastné vlastnosti majú configurable: false a jeho vlastné dátové vlastnosti majú navyše writable: false. Zohľadňujú sa symbolické kľúče a nevymenovateľné vlastnosti, nie však zdedené vlastnosti.
Metóda skúma stav namiesto toho, aby ho menila; na zmrazenie objektu použite Object.freeze. Samotné Object.seal nestačí, ak zostanú zapisovateľné dátové vlastnosti. Prázdny objekt je však po Object.preventExtensions zmrazený, pretože nemá vlastnosti, ktoré by porušovali ostatné podmienky.
Výsledok true neznamená hlbokú nemennosť. Objekty uložené ako hodnoty vlastností sa môžu naďalej meniť. Prístupové vlastnosti si môžu ponechať settery a gettery môžu vracať meniace sa výsledky; test nevyžaduje ich odstránenie ani nespúšťa gettery bežného objektu.
Pre primitívne hodnoty vrátane null a undefined vracia aktuálna špecifikácia true. Pri Proxy môže kontrola spustiť pasce a vyvolať výnimku, takže nejde vždy o operáciu bez vedľajších účinkov.
Prí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ýsledok
false true false true true true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.