Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Object.freeze: nejvyšší úroveň bez rozšíření a zápisu

Object.freeze zabrání rozšiřování a změně konfigurace vlastních vlastností a vlastní datové vlastnosti učiní nezapisovatelnými.

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

Syntaxe

Object.freeze(value)

Object.freeze(value) vrátí primitivní hodnotu beze změny. Pro objekt provede SetIntegrityLevel s úrovní frozen: zabrání novým vlastnostem, nastaví configurable: false na všech vlastních vlastnostech a také writable: false na vlastních datových vlastnostech. Vrací stejný objekt.

Přístupová vlastnost si ponechá getter a setter; ztratí jen konfigurovatelnost. Zmrazení je mělké: vnořené objekty, privátní prvky a interní data Map a Set se automaticky nestanou neměnnými. Setter může dál měnit vnořený či externí stav. Hluboká neměnnost vyžaduje řízený průchod datovým grafem bezpečný vůči cyklům.

Metoda existuje od ECMAScript 5; vracení neobjektových hodnot místo chyby platí od ECMAScript 2015. Selhání PreventExtensions nebo porušení invariantů Proxy vyvolá TypeError. Typovaná pole s prvky nelze zmrazit a také vyvolají TypeError; typované pole nulové délky zmrazit lze.

Pří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ýsledek

true true
false false function false
true true
7
TypeError

Příklad ověří datové a přístupové atributy, mělké zmrazení, primitivní hodnotu a chybu typovaného pole.

Zdroje