CKTIS / JavaScript
Object.seal — ein Objekt versiegeln
Object.seal verhindert, dass eigene Eigenschaften eines Objekts hinzugefügt oder gelöscht werden, macht das Objekt aber nicht unveränderlich. Bei gewöhnlichen Objekten lassen sich vorhandenen beschreibbaren Dateneigenschaften weiterhin neue Werte zuweisen; verschachtelte Objekte werden nicht automatisch versiegelt.
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.seal(obj)Object.seal(obj) verändert das übergebene Objekt und gibt dasselbe Objekt zurück, ohne eine Kopie anzulegen. Es verhindert Erweiterungen und setzt für alle eigenen Eigenschaften configurable: false, einschließlich nicht aufzählbarer und mit Symbol-Schlüsseln versehener Eigenschaften. Eigene Eigenschaften können danach weder hinzugefügt noch gelöscht werden; auch ihre Aufzählbarkeit lässt sich nicht ändern, und Dateneigenschaften können nicht in Accessoren oder umgekehrt umgewandelt werden.
Versiegeln bedeutet nicht Unveränderlichkeit. Bei einem gewöhnlichen Objekt lassen sich vorhandenen Dateneigenschaften mit writable: true weiterhin neue Werte zuweisen. writable lässt sich von true auf false ändern, aber nicht umgekehrt. Bei einem versiegelten Modul-Namensraumobjekt weisen die Deskriptoren der Exporteigenschaften writable: true aus. Das Objekt weist jedoch sowohl Zuweisungen an diese Eigenschaften als auch Versuche zurück, ihr Attribut writable auf false zu setzen. Vorhandene Setter können weiterhin ausgeführt werden. Der Vorgang wirkt flach: Verschachtelte Objekte werden nicht automatisch versiegelt.
Object.preventExtensions verhindert das Hinzufügen eigener Eigenschaften, setzt das Attribut configurable vorhandener Eigenschaften aber nicht selbst auf false. Bei einem gewöhnlichen Objekt setzt Object.freeze zusätzlich writable: false für eigene Dateneigenschaften; auch diese Operation wirkt flach. Den Versiegelungsstatus prüfst du mit Object.isSealed.
Im Strict Mode löst eine unzulässige Zuweisung einer neuen Eigenschaft oder das Löschen einer vorhandenen Eigenschaft mit delete einen TypeError aus; außerhalb des Strict Mode schlagen solche Vorgänge normalerweise ohne Ausnahme fehl. Object.seal kann eine Ausnahme auslösen, wenn das Versiegeln fehlschlägt, etwa bei manchen Proxy-Objekten. In modernem ECMAScript wird ein Argument, das kein Objekt ist, unverändert zurückgegeben.
Beispiele
"use strict";
const settings = { volume: 2, theme: { dark: false } };
const result = Object.seal(settings);
settings.volume = 3;
settings.theme.dark = true;
console.log(result === settings);
console.log(Object.isSealed(settings));
console.log(settings.volume, settings.theme.dark);
try {
settings.extra = 1;
} catch (error) {
console.log(error instanceof TypeError);
}
console.log(Reflect.deleteProperty(settings, "volume"));
console.log(Object.isSealed(settings.theme));Ergebnis
true true 3 true true false false
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.