Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Object.freeze: najvyššia úroveň bez rozšírenia a zápisu

Object.freeze zabráni rozširovaniu a zmene konfigurácie vlastných vlastností a vlastné dátové vlastnosti urobí nezapisovateľnými.

Verzia: ECMAScript 5 onward; primitive-return behavior since ECMAScript 2015; example target: Node.js 24.22.2

Syntax

Object.freeze(value)

Object.freeze(value) vráti primitívnu hodnotu bez zmeny. Pre objekt vykoná SetIntegrityLevel s úrovňou frozen: zabráni novým vlastnostiam, nastaví configurable: false na všetkých vlastných vlastnostiach a aj writable: false na vlastných dátových vlastnostiach. Vracia rovnaký objekt.

Prístupová vlastnosť si ponechá getter a setter; stratí iba konfigurovateľnosť. Zmrazenie je plytké: vnorené objekty, súkromné prvky a interné dáta Map a Set sa automaticky nestanú nemennými. Setter môže ďalej meniť vnorený či externý stav. Hlboká nemennosť vyžaduje riadený priechod dátovým grafom bezpečný voči cyklom.

Metóda existuje od ECMAScript 5; vracanie neobjektových hodnôt namiesto chyby platí od ECMAScript 2015. Zlyhanie PreventExtensions alebo porušenie invariantov Proxy vyvolá TypeError. Typované polia s prvkami nemožno zmraziť a tiež vyvolajú TypeError; typované pole nulovej dĺžky zmraziť možno.

Príklady

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); }

Výsledok

true true
false false function false
true true
7
TypeError

Príklad overí dátové a prístupové atribúty, plytké zmrazenie, primitívnu hodnotu a chybu typovaného poľa.

Zdroje