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

js
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:

js
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()

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

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
deleteProperty

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch