CKTIS / JavaScript
Object.seal — zapečetění objektu
Object.seal zabrání přidávání a mazání vlastních vlastností objektu, ale neučiní ho neměnným. U běžného objektu lze stávajícím zapisovatelným datovým vlastnostem dál přiřazovat nové hodnoty a vnořené objekty se automaticky nezapečetí.
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.seal(obj)Object.seal(obj) změní předaný objekt a vrátí tentýž objekt, aniž by vytvořil kopii. Zabrání jeho rozšiřování a u všech vlastních vlastností nastaví configurable: false, včetně neenumerovatelných vlastností a vlastností s klíči Symbol. Poté už nelze vlastní vlastnosti přidávat ani mazat, měnit jejich enumerovatelnost ani převádět datové vlastnosti na přístupové a naopak.
Zapečetění neznamená neměnnost. U běžného objektu lze stávajícím datovým vlastnostem s writable: true dál přiřazovat nové hodnoty a writable lze změnit z true na false, nikoli však opačně. Deskriptory vlastností odpovídajících exportům zapečetěného objektu jmenného prostoru modulu uvádějí writable: true, objekt však odmítá jak přiřazení do těchto vlastností, tak pokusy nastavit jejich atribut writable na false. Stávající settery mohou dál fungovat. Operace je mělká: vnořené objekty se automaticky nezapečetí.
Object.preventExtensions zabrání přidávání vlastních vlastností, ale samo o sobě nezpůsobí, že stávající vlastnosti nebudou konfigurovatelné. U běžného objektu Object.freeze navíc nastaví writable: false u vlastních datových vlastností; i tato operace je mělká. Stav zapečetění ověříte pomocí Object.isSealed.
V přísném režimu nepovolené přiřazení nové vlastnosti nebo smazání stávající vlastnosti pomocí delete vyvolá TypeError; mimo přísný režim tyto operace obvykle selžou bez výjimky. Object.seal může vyvolat výjimku, pokud zapečetění selže, například u některých objektů Proxy. V moderním ECMAScriptu se argument, který není objektem, vrátí beze změny.
Příklady
"use strict";
const settings = { volume: 2, theme: { dark: false } };
const result = Object.seal(settings);
settings.volume = 3;
settings.theme.dark = true;
console.log(result === settings);
console.log(Object.isSealed(settings));
console.log(settings.volume, settings.theme.dark);
try {
settings.extra = 1;
} catch (error) {
console.log(error instanceof TypeError);
}
console.log(Reflect.deleteProperty(settings, "volume"));
console.log(Object.isSealed(settings.theme));Výsledek
true true 3 true true false false
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.