Object.seal()

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

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

In diesem Artikel

Probieren Sie es aus

const object = {
  foo: 42,
};

Object.seal(object);
object.foo = 33;
console.log(object.foo);
// Expected output: 33

delete object.foo; // Cannot delete when sealed
console.log(object.foo);
// Expected output: 33

Syntax

Object.seal(obj)

Parameter

obj

Das Objekt, das versiegelt werden soll.

Rückgabewert

Das Objekt, das versiegelt wird.

Beschreibung

Das Versiegeln eines Objekts entspricht dem Verhindern von Erweiterungen und dann dem Ändern aller vorhandenen Eigenschaftsdescriptoren zu configurable: false. Dies hat zur Folge, dass der Satz von Eigenschaften des Objekts feststeht. Wenn alle Eigenschaften nicht konfigurierbar sind, können sie nicht von Dateneigenschaften zu Accessoreigenschaften und umgekehrt konvertiert werden, aber es wird nicht verhindert, dass die Werte der Dateneigenschaften geändert werden. Der Versuch, Eigenschaften eines versiegelten Objekts zu löschen oder hinzuzufügen oder eine Dateneigenschaft in einen Accessor zu konvertieren oder umgekehrt, schlägt fehl, entweder stillschweigend oder durch das Auslösen eines TypeError (meistens, aber nicht ausschließlich, wenn Code im strict mode ausgeführt wird).

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

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

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

Beispiele

Verwendung von Object.seal

js
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

Nicht-Objekt-Argument

In ES5 führt das Argument dieser Methode, wenn es sich nicht um ein Objekt (ein primitiver Wert) handelt, zu einem TypeError. In ES2015 wird ein Nicht-Objekt-Argument unverändert ohne Fehler zurückgegeben, da primitive Werte per Definition bereits unveränderlich sind.

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

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

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

Eingebaute Standardobjekte
Object
Konstruktor
1. Object()
Statische Methoden
Instanzmethoden
Instanzeigenschaften
1. __proto__
2. constructor
Vererbung
Object/Function
Statische Methoden
Statische Eigenschaften
Instanzmethoden
Instanzeigenschaften
1. __proto__
2. constructor