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 Reflect.deleteProperty()
statische Methode ähnelt dem delete
-Operator, ist jedoch eine 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, undefined, 5]
Syntax
Reflect.deleteProperty(target, propertyKey)
Parameter
target
-
Das Zielobjekt, von dem die Eigenschaft gelöscht werden soll.
propertyKey
-
Der Name der Eigenschaft, die gelöscht werden soll.
Rückgabewert
Ein Boolean, der angibt, ob die Eigenschaft erfolgreich gelöscht wurde oder nicht.
Ausnahmen
TypeError
-
Wird ausgelöst, wenn
target
kein Objekt ist.
Beschreibung
Reflect.deleteProperty()
bietet die reflektive Semantik des delete
-Operators. Das bedeutet, dass Reflect.deleteProperty(target, propertyKey)
semantisch äquivalent ist zu:
delete target.propertyKey;
Auf der niedrigsten Ebene gibt das Löschen einer Eigenschaft einen Boolean zurück (wie im Fall des Proxy-Handlers). Reflect.deleteProperty()
gibt diesen Status direkt zurück, während delete
einen TypeError
in Strict Mode auslöst, wenn der Status false
ist. Im Nicht-Strict Mode verhalten sich delete
und Reflect.deleteProperty()
identisch.
Reflect.deleteProperty()
ruft die [[Delete]]
-interne Objektmethode 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, undefined, 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® 2025 Language Specification # sec-reflect.deleteproperty |
Browser-Kompatibilität
Report problems with this compatibility data on GitHubdesktop | mobile | server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
deleteProperty |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support