CKTIS / JavaScript
Object.isSealed — prüfen, ob ein Objekt versiegelt ist
Object.isSealed(value) prüft, ob ein Objekt nicht erweiterbar ist und alle eigenen Eigenschaften nicht konfigurierbar sind. Das bedeutet weder, dass Werte unveränderlich sind, noch dass verschachtelte Objekte versiegelt sind.
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.isSealed(value)Object.isSealed(value) gibt true zurück, wenn das Objekt nicht erweiterbar ist und jede eigene Eigenschaft configurable: false hat. Die Prüfung umfasst auch nicht aufzählbare Eigenschaften und Symbol-Schlüssel, aber keine geerbten Eigenschaften. Sie prüft den Zustand; anders als Object.seal legt sie diese Einschränkungen nicht fest.
Das Versiegeln verhindert das Hinzufügen und Löschen eigener Eigenschaften sowie Änderungen, die durch ihre Nichtkonfigurierbarkeit untersagt sind. Das Versiegeln selbst ändert das Attribut writable nicht. Bei einem gewöhnlichen Objekt lässt sich einer beschreibbaren eigenen Dateneigenschaft weiterhin ein neuer Wert zuweisen. Bei exotischen Objekten garantiert writable: true jedoch nicht, dass eine Zuweisung gelingt. Ein versiegeltes Modul-Namensraumobjekt meldet beispielsweise für seine exportierten Bindungen writable: true, weist Zuweisungen an diese Bindungen aber zurück. Object.isFrozen verlangt zusätzlich, dass eigene Dateneigenschaften nicht beschreibbar sind. Keine der beiden Prüfungen ist rekursiv.
Object.preventExtensions allein reicht im Allgemeinen nicht aus, wenn konfigurierbare Eigenschaften vorhanden sind. Ein leeres, nicht erweiterbares Objekt ist jedoch versiegelt. Im aktuellen ECMAScript geben primitive Argumente, einschließlich null und undefined, true zurück; das bedeutet nicht, dass sie Objekte sind.
Bei einem Proxy kann die Prüfung Fallen auslösen und eine Ausnahme werfen, daher ist sie nicht immer eine nebenwirkungsfreie Untersuchung. Dies ist eine ECMAScript-Sprach-API, keine Browser-Web-API; die Sprachspezifikation ist keine Browser-Kompatibilitätstabelle.
Beispiele
const item = { count: 1, nested: { active: true } };
console.log(Object.isSealed(item));
Object.seal(item);
item.count = 2;
console.log(Object.isSealed(item));
console.log(Object.isFrozen(item));
console.log(item.count);
console.log(Object.isSealed(item.nested));
console.log(Object.isSealed(Object.preventExtensions({})));
console.log(Object.isSealed(null));Ergebnis
false true false 2 false 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.