Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori