Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri