Informationen
Das angeforderte Thema wird unten angezeigt. Es ist jedoch nicht in dieser Bibliothek vorhanden.

Object.seal-Funktion (JavaScript)

Verhindert die Änderung von Attributen vorhandener Eigenschaften und verhindert die Hinzufügung neuer Eigenschaften.

Object.seal(object)

object

Erforderlich. Das Objekt, dessen Attribute gesperrt werden sollen.

Das an die Funktion zu übergebende Objekt.

Wenn es sich beim object-Argument nicht um ein Objekt handelt, wird eine TypeError-Ausnahme ausgelöst.

Die Object.seal-Funktion führt beide der folgenden Aktionen aus:

  • Macht das Objekt nicht erweiterbar, sodass keine neuen Eigenschaften hinzugefügt werden können.

  • Legt das configurable-Attribut für alle Eigenschaften des Objekts auf false fest.

Wenn das configurable-Attribut den Wert false hat, können Eigenschaftenattribute nicht geändert werden, und die Eigenschaft kann nicht gelöscht werden. Wenn configurablefalse ist und writabletrue ist, können das value-Attribut und das writable-Attribut geändert werden.

Die Object.seal-Funktion ändert das writable-Attribut nicht.

Weitere Informationen über das Festlegen von Eigenschaftsattributen finden Sie unter Object.defineProperty-Funktion (JavaScript). Um die Attribute einer Eigenschaft abzurufen, können Sie Object.getOwnPropertyDescriptor-Funktion (JavaScript) verwenden.

Verwandte Funktionen

Die folgenden verwandten Funktionen verhindern die Änderung von Objektattributen.

Funktion

Das Objekt wird damit zu einem nicht erweiterbaren Objekt.

configurable wird für jede Eigenschaft auf false festgelegt.

writable wird für jede Eigenschaft auf false festgelegt.

Object.preventExtensions

Ja

Nein

Nein

Object.seal

Ja

Ja

Nein

Object.freeze

Ja

Ja

Ja

Die folgenden Funktionen geben true zurück, wenn alle Bedingungen, die in der folgenden Tabelle markiert sind, erfüllt werden.

Funktion

Ist das Objekt erweiterbar?

Ist configurable für alle Eigenschaften false?

Ist writable für alle Dateneigenschaften false?

Object.isExtensible

Ja

Nein

Nein

Object.isSealed

Nein

Ja

Nein

Object.isFrozen

Nein

Ja

Ja

Das folgende Beispiel veranschaulicht die Verwendung der Object.seal-Funktion.

// Create an object that has two properties.
var obj = { pasta: "spaghetti", length: 10 };
// Seal the object.
Object.seal(obj);
document.write(Object.isSealed(obj));
document.write("<br/>");

// Try to add a new property, and then verify that it is not added. 
obj.newProp = 50;
document.write(obj.newProp);
document.write("<br/>");

// Try to delete a property, and then verify that it is still present. 
delete obj.length;
document.write(obj.length);

// Output:
// true
// undefined
// 10

Wird in den folgenden Dokumentmodi unterstützt: Internet Explorer 9-Standardmodus, Internet Explorer 10-Standardmodus und Internet Explorer 11-Standardmodus. Wird auch unterstützt von Apps aus dem Store (Windows 8 und Windows Phone 8.1). Siehe Versionsinformationen.

Wird in den folgenden Dokumentmodi nicht unterstützt: Quirksmodus, Internet Explorer 6-Standardmodus, Internet Explorer 7-Standardmodus, Internet Explorer 8-Standardmodus.

Community-Beiträge

Anzeigen:
© 2014 Microsoft