Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Object.seal — zapečatenie objektu

Object.seal zabráni pridávaniu a mazaniu vlastných vlastností objektu, ale neurobí ho nemenným. V bežnom objekte možno existujúcim zapisovateľným dátovým vlastnostiam naďalej priraďovať nové hodnoty a vnorené objekty sa automaticky nezapečatia.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

Object.seal(obj)

Object.seal(obj) zmení odovzdaný objekt a vráti ten istý objekt bez vytvorenia kópie. Zabráni jeho rozširovaniu a pri všetkých vlastných vlastnostiach nastaví configurable: false, vrátane neenumerovateľných vlastností a vlastností s kľúčmi Symbol. Vlastné vlastnosti už nemožno pridávať ani mazať, meniť ich enumerovateľnosť ani prevádzať dátové vlastnosti na prístupové a naopak.

Zapečatenie neznamená nemennosť. V bežnom objekte možno existujúcim dátovým vlastnostiam s writable: true naďalej priraďovať nové hodnoty a writable možno zmeniť z true na false, nie však opačne. Deskriptory vlastností zodpovedajúcich exportom zapečateného objektu menného priestoru modulu uvádzajú writable: true, objekt však odmieta priradenia do týchto vlastností aj pokusy nastaviť ich atribút writable na false. Existujúce settery môžu naďalej fungovať. Operácia je plytká: vnorené objekty sa automaticky nezapečatia.

Object.preventExtensions zabráni pridávaniu vlastných vlastností, ale samo osebe nespôsobí, že existujúce vlastnosti nebudú konfigurovateľné. V bežnom objekte Object.freeze navyše nastaví writable: false pri vlastných dátových vlastnostiach; aj táto operácia je plytká. Stav zapečatenia skontrolujete pomocou Object.isSealed.

V prísnom režime nepovolené priradenie novej vlastnosti alebo odstránenie existujúcej vlastnosti pomocou delete vyvolá TypeError; mimo prísneho režimu tieto operácie zvyčajne zlyhajú bez výnimky. Object.seal môže vyvolať výnimku, ak sa zapečatenie nepodarí, napríklad pri niektorých objektoch Proxy. V modernom ECMAScripte sa argument, ktorý nie je objektom, vráti bez zmeny.

Prí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ýsledok

true
true
3 true
true
false
false

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje