CKTIS / JavaScript
Reflect.deleteProperty — Eigenschaften mit booleschem Ergebnis löschen
Reflect.deleteProperty(target, propertyKey) versucht, eine eigene Eigenschaft eines Objekts zu löschen, und gibt einen booleschen Wert zurück. Bei einem gewöhnlichen Objekt gibt die Methode auch dann true zurück, wenn die Eigenschaft nicht existiert, und false, wenn sie configurable: false hat.
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
Reflect.deleteProperty(target, propertyKey)Reflect.deleteProperty(target, propertyKey) ruft die interne [[Delete]]-Operation des Objekts auf. target muss ein Objekt sein; ein primitiver Wert, einschließlich null, führt zu einem TypeError. propertyKey wird in einen Eigenschaftsschlüssel umgewandelt: einen String oder ein Symbol.
Bei einem gewöhnlichen Objekt entfernt die Methode eine eigene Eigenschaft, wenn ihr Attribut configurable den Wert true hat. In diesem Fall gibt sie true zurück; sie gibt auch true zurück, wenn keine eigene Eigenschaft vorhanden ist. Eine Eigenschaft mit configurable: false bleibt unverändert, und das Ergebnis ist false. Die Methode löscht keine Eigenschaften aus dem Prototyp: Durch das Löschen einer eigenen Eigenschaft kann eine geerbte Eigenschaft mit demselben Schlüssel sichtbar werden.
Anders als delete target[propertyKey] im Strict Mode gibt die Methode false zurück, statt allein wegen einer verweigerten Löschung einen Fehler auszulösen. Das bedeutet nicht, dass sie niemals Fehler auslöst: Ausnahmen können bei der Umwandlung des Schlüssels oder durch einen Proxy auftreten, dessen deleteProperty-Trap den Vorgang abfangen kann und den Invarianten der Spezifikation unterliegt.
Das Beispiel zeigt das Löschen einer Eigenschaft, eine nicht vorhandene Eigenschaft und eine verweigerte Löschung im Strict Mode. Dies ist eine Funktion der ECMAScript-Standardbibliothek, keine Web-API. Die Spezifikation allein belegt nicht, dass sie in einer bestimmten Browserversion unterstützt wird; auch das Vorhandensein von Node 24 in einem Repository belegt dies nicht.
Beispiele
"use strict";
const item = { temporary: 1 };
Object.defineProperty(item, "fixed", {
value: 2,
configurable: false
});
console.log(Reflect.deleteProperty(item, "temporary"));
console.log(Reflect.deleteProperty(item, "missing"));
console.log(Reflect.deleteProperty(item, "fixed"));
console.log(Object.prototype.hasOwnProperty.call(item, "temporary"));
console.log(item.fixed);Ergebnis
true true false false 2
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.