Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Object.seal — zapečatenje objekta

Object.seal prepreči dodajanje in brisanje lastnih lastnosti objekta, vendar ga ne naredi nespremenljivega. Pri običajnem objektu je obstoječim zapisljivim podatkovnim lastnostim še vedno mogoče dodeliti nove vrednosti, ugnezdeni objekti pa niso samodejno zapečateni.

Različica: 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) spremeni podani objekt in vrne isti objekt, ne da bi ustvaril kopijo. Prepreči njegovo razširjanje ter za vse lastne lastnosti nastavi configurable: false, tudi za neenumerabilne lastnosti in lastnosti s ključi Symbol. Lastnih lastnosti nato ni več mogoče dodajati ali brisati, spreminjati njihove enumerabilnosti ali pretvarjati podatkovnih lastnosti v dostopnike in obratno.

Zapečatenje ne pomeni nespremenljivosti. Pri običajnem objektu je obstoječim podatkovnim lastnostim z writable: true še vedno mogoče dodeliti nove vrednosti, writable pa je mogoče spremeniti iz true v false, ne pa obratno. Deskriptorji lastnosti, ki ustrezajo izvozom zapečatenega objekta imenskega prostora modula, navajajo writable: true, vendar objekt zavrne tako dodeljevanje vrednosti tem lastnostim kot poskuse nastavitve njihovega atributa writable na false. Obstoječi setterji lahko še naprej delujejo. Operacija je plitva: ugnezdeni objekti niso samodejno zapečateni.

Object.preventExtensions prepreči dodajanje lastnih lastnosti, vendar sam po sebi obstoječih lastnosti ne naredi nekonfigurabilnih. Pri običajnem objektu Object.freeze dodatno nastavi writable: false za lastne podatkovne lastnosti; tudi ta operacija je plitva. Zapečatenost preverite z Object.isSealed.

V strogem načinu nedovoljena dodelitev nove lastnosti ali brisanje obstoječe lastnosti z delete sproži TypeError; zunaj strogega načina ti operaciji običajno spodletita brez izjeme. Object.seal lahko sproži izjemo, če zapečatenje ne uspe, na primer pri nekaterih objektih Proxy. V sodobnem ECMAScriptu se argument, ki ni objekt, vrne nespremenjen.

Primeri

"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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri