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

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.

Zdroje