CKTIS / JavaScript
Object.isSealed — preverjanje, ali je objekt zapečaten
Object.isSealed(value) preveri, ali objekta ni mogoče razširiti in ali so vse njegove lastne lastnosti nekonfigurabilne. To ne pomeni, da so vrednosti nespremenljive ali da so zapečateni tudi ugnezdeni objekti.
Različica: 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.isSealed(value)Object.isSealed(value) vrne true, kadar objekta ni mogoče razširiti in ima vsaka njegova lastna lastnost configurable: false. Preverjanje vključuje tudi neštevne lastnosti in ključe Symbol, ne pa podedovanih lastnosti. Pregleda stanje; za razliko od Object.seal teh omejitev ne uvede.
Zapečatenje prepreči dodajanje in brisanje lastnih lastnosti ter spremembe, ki jih prepoveduje njihova nekonfigurabilnost. Zapečatenje samo po sebi ne spremeni atributa writable. Pri običajnem objektu je zapisljivi lastni podatkovni lastnosti še vedno mogoče dodeliti novo vrednost. Pri eksotičnih objektih pa writable: true ne zagotavlja, da bo dodelitev uspela. Zapečateni objekt imenskega prostora modula na primer za izvožene vezave navaja writable: true, vendar zavrne dodeljevanje vrednosti tem vezavam. Object.isFrozen poleg tega zahteva, da lastne podatkovne lastnosti niso zapisljive. Nobeno od preverjanj ni rekurzivno.
Samo Object.preventExtensions običajno ne zadostuje, če ostanejo konfigurabilne lastnosti. Prazen objekt, ki ga ni mogoče razširiti, pa je zapečaten. V trenutnem ECMAScriptu primitivni argumenti, vključno z null in undefined, vrnejo true; to ne pomeni, da so objekti.
Pri objektu Proxy lahko preverjanje sproži pasti in izjemo, zato ni vedno pregled brez stranskih učinkov. To je jezikovni API ECMAScript, ne spletni API brskalnika; jezikovna specifikacija ni tabela združljivosti brskalnikov.
Primeri
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));Rezultat
false true false 2 false true true
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.