CKTIS / JavaScript
Object.isSealed — kontrola, či je objekt zapečatený
Object.isSealed(value) kontroluje, či objekt nie je rozšíriteľný a všetky jeho vlastné vlastnosti sú nekonfigurovateľné. Neznamená to, že hodnoty sú nemenné alebo že sú zapečatené aj 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.isSealed(value)Object.isSealed(value) vráti true, keď objekt nie je rozšíriteľný a každá jeho vlastná vlastnosť má configurable: false. Kontrola zahŕňa aj nevymenovateľné vlastnosti a kľúče Symbol, nie však zdedené vlastnosti. Kontroluje stav; na rozdiel od Object.seal tieto obmedzenia nenastavuje.
Zapečatenie bráni pridávaniu a odstraňovaniu vlastných vlastností a zmenám zakázaným ich nekonfigurovateľnosťou. Samotné zapečatenie nemení atribút writable. Pri bežnom objekte možno zapisovateľnej vlastnej dátovej vlastnosti naďalej priradiť novú hodnotu. Pri exotických objektoch však writable: true nezaručuje, že priradenie bude úspešné. Napríklad zapečatený objekt menného priestoru modulu uvádza pri exportovaných väzbách writable: true, no priradenie hodnôt do týchto väzieb odmieta. Object.isFrozen navyše vyžaduje, aby vlastné dátové vlastnosti neboli zapisovateľné. Ani jedna kontrola nie je rekurzívna.
Samotné Object.preventExtensions zvyčajne nestačí, ak zostanú konfigurovateľné vlastnosti. Prázdny objekt, ktorý nie je rozšíriteľný, je však zapečatený. V súčasnom ECMAScripte vracajú primitívne argumenty vrátane null a undefined hodnotu true; neznamená to, že sú objektmi.
Pri objekte Proxy môže kontrola vyvolať pasce a spôsobiť výnimku, preto nejde vždy o kontrolu bez vedľajších účinkov. Je to API jazyka ECMAScript, nie webové API prehliadača; špecifikácia jazyka nie je tabuľkou kompatibility prehliadačov.
Príklady
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));Výsledok
false true false 2 false 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.