CKTIS / JavaScript
Object.seal — zapečaćivanje objekta
Object.seal sprječava dodavanje i brisanje vlastitih svojstava objekta, ali ga ne čini nepromjenjivim. U običnom objektu postojećim zapisivim podatkovnim svojstvima i dalje se mogu dodjeljivati nove vrijednosti, a ugniježđeni objekti ne zapečaćuju se automatski.
Verzija: 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.seal(obj)Object.seal(obj) mijenja predani objekt i vraća taj isti objekt, bez stvaranja kopije. Sprječava njegovo proširivanje i postavlja configurable: false za sva vlastita svojstva, uključujući ona koja nisu enumerabilna i ona s ključevima Symbol. Nakon toga nije moguće dodavati ni brisati vlastita svojstva, mijenjati njihovu enumerabilnost ni pretvarati podatkovna svojstva u pristupnike i obratno.
Zapečaćivanje ne znači nepromjenjivost. U običnom objektu postojećim podatkovnim svojstvima s writable: true i dalje se mogu dodjeljivati nove vrijednosti, a writable je moguće promijeniti iz true u false, ali ne i obratno. Deskriptori svojstava koja odgovaraju izvozima zapečaćenog objekta imenskog prostora modula navode writable: true, ali objekt odbija i dodjele vrijednosti tim svojstvima i pokušaje postavljanja njihova atributa writable na false. Postojeći setteri i dalje mogu raditi. Operacija je plitka: ugniježđeni objekti ne zapečaćuju se automatski.
Object.preventExtensions sprječava dodavanje vlastitih svojstava, ali sam po sebi postojeća svojstva ne čini nekonfigurabilnima. U običnom objektu Object.freeze dodatno postavlja writable: false za vlastita podatkovna svojstva; i ta je operacija plitka. Zapečaćenost provjerite pomoću Object.isSealed.
U strogom načinu rada nedopuštena dodjela novog svojstva ili brisanje postojećeg svojstva pomoću delete izaziva TypeError; izvan strogog načina rada takve operacije obično ne uspiju bez iznimke. Object.seal može izazvati iznimku ako zapečaćivanje ne uspije, primjerice kod nekih Proxy objekata. U modernom ECMAScriptu argument koji nije objekt vraća se nepromijenjen.
Primjeri
"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));Rezultat
true true 3 true true false false
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.