Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Object.isSealed — ověření, zda je objekt zapečetěný

Object.isSealed(value) ověřuje, zda objekt nelze rozšiřovat a všechny jeho vlastní vlastnosti jsou nekonfigurovatelné. Neznamená to, že hodnoty jsou neměnné nebo že jsou zapečetěné i 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.isSealed(value)

Object.isSealed(value) vrací true, pokud objekt nelze rozšiřovat a každá jeho vlastní vlastnost má configurable: false. Kontrola zahrnuje i nevyjmenovatelné vlastnosti a klíče Symbol, nikoli však zděděné vlastnosti. Zjišťuje stav; na rozdíl od Object.seal tato omezení nenastavuje.

Zapečetění brání přidávání a mazání vlastních vlastností a změnám zakázaným jejich nekonfigurovatelností. Samotné zapečetění nemění atribut writable. U běžného objektu lze zapisovatelné vlastní datové vlastnosti stále přiřadit novou hodnotu. U exotických objektů však writable: true nezaručuje, že přiřazení uspěje. Například zapečetěný objekt jmenného prostoru modulu u exportovaných vazeb uvádí writable: true, ale přiřazení hodnot do těchto vazeb odmítá. Object.isFrozen navíc vyžaduje, aby vlastní datové vlastnosti nebyly zapisovatelné. Ani jedna z kontrol není rekurzivní.

Samotné Object.preventExtensions obvykle nestačí, pokud zůstávají konfigurovatelné vlastnosti. Prázdný objekt, který nelze rozšiřovat, je však zapečetěný. V současném ECMAScriptu vracejí primitivní argumenty, včetně null a undefined, hodnotu true; neznamená to, že jsou objekty.

U objektu Proxy může kontrola vyvolat pasti a způsobit výjimku, takže nejde vždy o kontrolu bez vedlejších účinků. Jde o API jazyka ECMAScript, nikoli o webové API prohlížeče; specifikace jazyka není tabulkou kompatibility prohlížečů.

Pří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ýsledek

false
true
false
2
false
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.

Zdroje