CKTIS / JavaScript
Object.isFrozen — prüfen, ob ein Objekt eingefroren ist
Object.isFrozen(value) prüft, ob ein Objekt nicht erweiterbar ist, seine eigenen Eigenschaften nicht konfigurierbar sind und seine Dateneigenschaften zusätzlich nicht beschreibbar sind. Die Methode friert das Objekt nicht ein und prüft verschachtelte Objekte nicht rekursiv.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
Object.isFrozen(value)Object.isFrozen(value) ist eine statische Methode, die true zurückgibt, wenn ein Objekt keine eigenen Eigenschaften hinzufügen kann, alle eigenen Eigenschaften configurable: false haben und die eigenen Dateneigenschaften zusätzlich writable: false haben. Symbolschlüssel und nicht aufzählbare Eigenschaften werden einbezogen, geerbte Eigenschaften dagegen nicht.
Die Methode untersucht den Zustand, statt ihn zu ändern; zum Einfrieren eines Objekts dient Object.freeze. Object.seal allein reicht nicht aus, wenn beschreibbare Dateneigenschaften bestehen bleiben. Ein leeres Objekt ist nach Object.preventExtensions jedoch bereits eingefroren, da es keine Eigenschaften gibt, die die übrigen Bedingungen verletzen.
Ein Ergebnis von true bedeutet keine tiefe Unveränderlichkeit. Objekte, die als Eigenschaftswerte gespeichert sind, können weiterhin geändert werden. Accessor-Eigenschaften können Setter behalten, und Getter können wechselnde Ergebnisse liefern; die Prüfung verlangt weder, diese zu entfernen, noch ruft sie die Getter eines gewöhnlichen Objekts auf.
Für primitive Werte, einschließlich null und undefined, liefert die aktuelle Spezifikation true. Bei einem Proxy kann die Prüfung Fallen auslösen und eine Ausnahme werfen; sie ist daher nicht immer frei von Seiteneffekten.
Beispiele
const settings = { theme: { dark: false } };
console.log(Object.isFrozen(settings));
Object.freeze(settings);
console.log(Object.isFrozen(settings));
console.log(Object.isFrozen(settings.theme));
settings.theme.dark = true;
console.log(settings.theme.dark);
console.log(Object.isFrozen(Object.preventExtensions({})));
console.log(Object.isFrozen(null));Ergebnis
false true false true true true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.