CKTIS / JavaScript
Object.freeze: vrhnja raven brez razširjanja in pisanja
Object.freeze prepreči razširjanje in preoblikovanje lastnih lastnosti ter naredi lastne podatkovne lastnosti nezapisljive.
Različica: ECMAScript 5 onward; primitive-return behavior since ECMAScript 2015; example target: Node.js 24.22.2
Sintaksa
Object.freeze(value)Object.freeze(value) vrne primitivno vrednost nespremenjeno. Za objekt izvede SetIntegrityLevel na ravni frozen: prepreči nove lastnosti, nastavi configurable: false na vseh lastnih lastnostih in tudi writable: false na lastnih podatkovnih lastnostih. Vrne isti objekt.
Dostopna lastnost ohrani getter in setter; izgubi le konfigurabilnost. Zamrznitev je plitva: ugnezdeni objekti, zasebni elementi in notranji podatki Map ter Set ne postanejo samodejno nespremenljivi. Setter lahko še vedno spremeni ugnezdeno ali zunanje stanje. Globoka nespremenljivost zahteva nadzorovan, na cikle odporen prehod podatkovnega grafa.
Metoda obstaja od ECMAScript 5; vračanje neobjektnih vrednosti namesto izjeme velja od ECMAScript 2015. Neuspeh PreventExtensions ali kršitev invariant Proxy sproži TypeError. Typed arrays z elementi ni mogoče zamrzniti in prav tako sprožijo TypeError; typed array ničelne dolžine pa je mogoče.
Primeri
const config = {
nested: { enabled: false },
get status() { return this.nested.enabled; },
set status(value) { this.nested.enabled = value; }
};
const same = Object.freeze(config);
const nested = Object.getOwnPropertyDescriptor(config, "nested");
const status = Object.getOwnPropertyDescriptor(config, "status");
console.log(same === config, Object.isFrozen(config));
console.log(nested.writable, nested.configurable, typeof status.set, status.configurable);
config.status = true;
console.log(config.nested.enabled, config.status);
console.log(Object.freeze(7));
try { Object.freeze(new Uint8Array([1])); }
catch (error) { console.log(error.name); }Rezultat
true true false false function false true true 7 TypeError
Primer potrdi podatkovne in dostopne atribute, plitvo zamrznitev, primitivno vrednost in napako typed array.