Reflect.deleteProperty()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2016.
Die statische Methode Reflect.deleteProperty() ist wie der delete Operator, jedoch als Funktion. Sie löscht eine Eigenschaft aus einem Objekt.
Probieren Sie es aus
const object1 = {
property1: 42,
};
Reflect.deleteProperty(object1, "property1");
console.log(object1.property1);
// Expected output: undefined
const array1 = [1, 2, 3, 4, 5];
Reflect.deleteProperty(array1, "3");
console.log(array1);
// Expected output: Array [1, 2, 3, <1 empty slot>, 5]
Syntax
Reflect.deleteProperty(target, propertyKey)
Parameter
target-
Das Zielobjekt, von dem die Eigenschaft gelöscht werden soll.
propertyKey-
Der Name der zu löschenden Eigenschaft.
Rückgabewert
Ein boolescher Wert, der angibt, ob die Eigenschaft erfolgreich gelöscht wurde oder nicht.
Ausnahmen
TypeError-
Ausgelöst, wenn
targetkein Objekt ist.
Beschreibung
Reflect.deleteProperty() bietet die reflektierende Semantik des delete Operators. Das bedeutet, Reflect.deleteProperty(target, propertyKey) ist semantisch äquivalent zu:
delete target.propertyKey;
Auf sehr niedriger Ebene liefert das Löschen einer Eigenschaft einen booleschen Wert zurück (wie es bei dem Proxy-Handler der Fall ist). Reflect.deleteProperty() gibt direkt den Status zurück, während delete in strict mode einen TypeError auslösen würde, wenn der Status false ist. Im nicht-strikten Modus haben delete und Reflect.deleteProperty() dasselbe Verhalten.
Reflect.deleteProperty() ruft die [[Delete]] interne Objektsmethode von target auf.
Beispiele
Verwendung von Reflect.deleteProperty()
const obj = { x: 1, y: 2 };
Reflect.deleteProperty(obj, "x"); // true
console.log(obj); // { y: 2 }
const arr = [1, 2, 3, 4, 5];
Reflect.deleteProperty(arr, "3"); // true
console.log(arr); // [1, 2, 3, <1 empty slot>, 5]
// Returns true if no such property exists
Reflect.deleteProperty({}, "foo"); // true
// Returns false if a property is unconfigurable
Reflect.deleteProperty(Object.freeze({ foo: 1 }), "foo"); // false
Spezifikationen
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-reflect.deleteproperty |