WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Object.freeze: oberste Ebene nicht erweiterbar und nicht beschreibbar

Object.freeze verhindert Erweiterung und Neukonfiguration eigener Eigenschaften und macht eigene Dateneigenschaften nicht beschreibbar.

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

Syntax

Object.freeze(value)

Object.freeze(value) gibt einen primitiven Wert unverändert zurück. Bei einem Objekt führt es SetIntegrityLevel mit Stufe frozen aus: Neue Eigenschaften werden verhindert, alle eigenen Eigenschaften erhalten configurable: false, eigene Dateneigenschaften zusätzlich writable: false. Zurück kommt dasselbe Objekt.

Eine Accessoreigenschaft behält Getter und Setter; nur ihre Konfigurierbarkeit entfällt. Einfrieren ist flach: Verschachtelte Objekte, private Elemente und interne Daten von Map und Set werden nicht automatisch unveränderlich. Ein Setter kann weiterhin verschachtelten oder externen Zustand ändern. Tiefe Unveränderlichkeit verlangt eine kontrollierte, zyklussichere Traversierung des Datengraphen.

Die Methode existiert seit ECMAScript 5; nichtobjektartige Werte statt eines Fehlers zurückzugeben gilt seit ECMAScript 2015. Scheitert PreventExtensions oder verletzt ein Proxy Invarianten, wird TypeError geworfen. Typisierte Arrays mit Elementen können nicht eingefroren werden und werfen ebenfalls; ein leeres typisiertes Array kann eingefroren werden.

Beispiele

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

Ergebnis

true true
false false function false
true true
7
TypeError

Das Beispiel bestätigt Daten- und Accessorattribute, flaches Einfrieren, primitive Werte und den Typed-Array-Fehler.

Quellen