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

Syntax

js
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 boolean-Wert, 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 heißt, Reflect.deleteProperty(target, propertyKey) ist semantisch gleichwertig mit:

js
delete target.propertyKey;

Auf sehr niedriger Ebene gibt das Löschen einer Eigenschaft ein boolean zurück (wie es bei dem Proxy-Handler der Fall ist). Reflect.deleteProperty() gibt direkt den Status zurück, während delete einen TypeError in strict mode werfen würde, wenn der Status false ist. Im Nicht-strict mode verhalten sich delete und Reflect.deleteProperty() gleich.

Reflect.deleteProperty() ruft die [[Delete]] interne Objekte-Methode von target auf.

Beispiele

Verwendung von Reflect.deleteProperty()

js
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 Language Specification
# sec-reflect.deleteproperty

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch