CKTIS / JavaScript
Object.freeze: najviša razina bez proširenja i pisanja
Object.freeze sprječava proširenje i promjenu konfiguracije vlastitih svojstava te vlastita podatkovna svojstva čini nezapisivima.
Verzija: ECMAScript 5 onward; primitive-return behavior since ECMAScript 2015; example target: Node.js 24.22.2
Sintaksa
Object.freeze(value)Object.freeze(value) vraća primitivnu vrijednost nepromijenjenu. Za objekt izvodi SetIntegrityLevel na razini frozen: sprječava nova svojstva, postavlja configurable: false na sva vlastita svojstva i također writable: false na vlastita podatkovna svojstva. Vraća isti objekt.
Pristupno svojstvo zadržava getter i setter; gubi samo konfigurabilnost. Zamrzavanje je plitko: ugniježđeni objekti, privatni elementi i interni podaci Map i Set ne postaju automatski nepromjenjivi. Setter i dalje može mijenjati ugniježđeno ili vanjsko stanje. Duboka nepromjenjivost zahtijeva kontroliran prolaz grafa podataka siguran od ciklusa.
Metoda postoji od ECMAScript 5; vraćanje neobjektnih vrijednosti umjesto greške vrijedi od ECMAScript 2015. Neuspjeh PreventExtensions ili kršenje invarijanti Proxyja baca TypeError. Typed arrays s elementima ne mogu se zamrznuti i također bacaju TypeError; typed array nulte duljine može.
Primjeri
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
Primjer potvrđuje podatkovne i pristupne atribute, plitko zamrzavanje, primitivnu vrijednost i grešku typed array.