handler.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 Methode handler.deleteProperty() ist eine Trap für die [[Delete]]-Methode internen Objekts, die von Operationen wie dem delete-Operator verwendet wird.

Probieren Sie es aus

Syntax

js
new Proxy(target, {
  deleteProperty(target, property) {
  }
})

Parameter

Die folgenden Parameter werden an die Methode deleteProperty() übergeben. this ist an den Handler gebunden.

target

Das Zielobjekt.

property

Ein String oder ein Symbol, der den Eigenschaftsnamen darstellt.

Rückgabewert

Die Methode deleteProperty() muss einen Boolean zurückgeben, der angibt, ob die Eigenschaft erfolgreich gelöscht wurde oder nicht. Andere Werte werden zu Booleans konvertiert.

Viele Operationen, einschließlich des delete-Operators im strict mode, werfen einen TypeError, wenn die [[Delete]]-Methode false zurückgibt.

Beschreibung

Interzeptionen

Diese Trap kann folgende Operationen abfangen:

Oder jede andere Operation, die die [[Delete]]-Methode internen Objekts aufruft.

Invarianten

Die [[Delete]]-Methode des Proxy-Objekts wirft einen TypeError, wenn die Handler-Definition eine der folgenden Invarianten verletzt:

  • Eine Eigenschaft kann nicht als gelöscht gemeldet werden, wenn sie als nicht konfigurierbare eigene Eigenschaft des Zielobjekts existiert. Das heißt, wenn Reflect.getOwnPropertyDescriptor() für die Eigenschaft auf target configurable: false zurückgibt, dann muss die Trap einen falschen Wert zurückgeben.
  • Eine Eigenschaft kann nicht als gelöscht gemeldet werden, wenn sie als eigene Eigenschaft des Zielobjekts existiert und das Zielobjekt nicht erweiterbar ist. Das heißt, wenn Reflect.isExtensible() auf target false zurückgibt und Reflect.getOwnPropertyDescriptor() einen Eigenschaftsdescriptor für die Eigenschaft auf target zurückgibt, dann muss die Trap einen falschen Wert zurückgeben.

Beispiele

Den delete-Operator abfangen

Der folgende Code fängt den delete-Operator ab.

js
const p = new Proxy(
  {},
  {
    deleteProperty(target, prop) {
      if (!(prop in target)) {
        console.log(`property not found: ${prop}`);
        return false;
      }
      delete target[prop];
      console.log(`property removed: ${prop}`);
      return true;
    },
  },
);

p.a = 10;
console.log("a" in p); // true

const result1 = delete p.a; // "property removed: a"
console.log(result1); // true
console.log("a" in p); // false

const result2 = delete p.a; // "property not found: a"
console.log(result2); // false

Spezifikationen

Specification
ECMAScript Language Specification
# sec-proxy-object-internal-methods-and-internal-slots-delete-p

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch