Object.seal()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die statische Methode Object.seal() versiegelt ein Objekt. Das Versiegeln eines Objekts verhindert Erweiterungen und macht bestehende Eigenschaften nicht konfigurierbar. Ein versiegeltes Objekt hat einen festen Satz von Eigenschaften: Neue Eigenschaften können nicht hinzugefügt werden, bestehende Eigenschaften können nicht entfernt werden, ihre Enumerierbarkeit und Konfigurierbarkeit können nicht geändert werden, und ihr Prototyp kann nicht neu zugewiesen werden. Die Werte der bestehenden Eigenschaften können jedoch geändert werden, solange sie beschreibbar sind. seal() gibt dasselbe Objekt zurück, das übergeben wurde.

Probieren Sie es aus

const object1 = {
  property1: 42,
};

Object.seal(object1);
object1.property1 = 33;
console.log(object1.property1);
// Expected output: 33

delete object1.property1; // Cannot delete when sealed
console.log(object1.property1);
// Expected output: 33

Syntax

Object.seal(obj)

Parameter

obj: Das Objekt, das versiegelt werden soll.

Rückgabewert

Das versiegelte Objekt.

Beschreibung

Das Versiegeln eines Objekts ist gleichbedeutend mit dem Verhindern von Erweiterungen und dem anschließenden Ändern aller bestehenden Eigenschafts-Deskriptoren zu configurable: false. Dies hat zur Folge, dass der Satz der Eigenschaften des Objekts festgelegt wird. Wenn alle Eigenschaften nicht konfigurierbar sind, verhindert das außerdem, dass Daten-Eigenschaften in Zugriffseigenschaften und umgekehrt umgewandelt werden, aber es verhindert nicht, dass die Werte von Daten-Eigenschaften geändert werden. Der Versuch, Eigenschaften eines versiegelten Objekts zu löschen oder hinzuzufügen oder eine Daten-Eigenschaft in eine Zugriffseigenschaft oder umgekehrt umzuwandeln, schlägt fehl, entweder stillschweigend oder indem ein TypeError ausgelöst wird (meistens, aber nicht ausschließlich, wenn im strict mode Code).

Private Elemente sind keine Eigenschaften und haben kein Konzept von Eigenschafts-Deskriptoren. Private Elemente können weder hinzugefügt noch entfernt werden, unabhängig davon, ob das Objekt versiegelt ist oder nicht.

Die Prototypen-Kette bleibt unberührt. Aufgrund der Wirkung des Verhinderns von Erweiterungen kann der [[Prototype]] jedoch nicht neu zugewiesen werden.

Im Gegensatz zu Object.freeze() können bei Objekten, die mit Object.seal() versiegelt wurden, ihre bestehenden Eigenschaften geändert werden, solange sie beschreibbar sind.

Beispiele

Verwendung von Object.seal

const obj = {
  prop() {},
  foo: "bar",
};

// New properties may be added, existing properties
// may be changed or removed.
obj.foo = "baz";
obj.lumpy = "woof";
delete obj.prop;

const o = Object.seal(obj);

o === obj; // true
Object.isSealed(obj); // true

// Changing property values on a sealed object
// still works.
obj.foo = "quux";

// But you can't convert data properties to accessors,
// or vice versa.
Object.defineProperty(obj, "foo", {
  get() {
    return "g";
  },
}); // throws a TypeError

// Now any changes, other than to property values,
// will fail.
obj.quaxxor = "the friendly duck";
// silently doesn't add the property
delete obj.foo;
// silently doesn't delete the property

// … and in strict mode such attempts
// will throw TypeErrors.
function fail() {
  "use strict";
  delete obj.foo; // throws a TypeError
  obj.sparky = "arf"; // throws a TypeError
}
fail();

// Attempted additions through
// Object.defineProperty will also throw.
Object.defineProperty(obj, "ohai", {
  value: 17,
}); // throws a TypeError
Object.defineProperty(obj, "foo", {
  value: "eit",
}); // changes existing property value

Argument, das kein Objekt ist

In ES5, wenn das Argument dieser Methode kein Objekt (ein primitiver Wert) ist, führt dies zu einem TypeError. In ES2015 wird ein nicht-objekt Argument unverändert zurückgegeben, ohne Fehler, da primitive Werte definitionsgemäß bereits unveränderlich sind.

Object.seal(1);
// TypeError: 1 is not an object (ES5 code)

Object.seal(1);
// 1                             (ES2015 code)

Spezifikationen

Specification
ECMAScript® 2026 Language Specification # sec-object.seal