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]] interne Objektmethode, die von Operationen wie dem delete-Operator verwendet wird.

Probieren Sie es aus

const monster1 = {
  texture: "scaly",
};

const handler1 = {
  deleteProperty(target, prop) {
    if (prop in target) {
      delete target[prop];
      console.log(`property removed: ${prop}`);
      // Expected output: "property removed: texture"
    }
  },
};

console.log(monster1.texture);
// Expected output: "scaly"

const proxy1 = new Proxy(monster1, handler1);
delete proxy1.texture;

console.log(monster1.texture);
// Expected output: undefined

Syntax

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, das den Eigenschaftsnamen repräsentiert.

Rückgabewert

Die Methode deleteProperty() muss ein Boolean zurückgeben, das angibt, ob die Eigenschaft erfolgreich gelöscht wurde oder nicht. Andere Werte werden in Booleans umgewandelt.

Viele Operationen, einschließlich des delete-Operators im Strict-Modus, lösen einen TypeError aus, wenn die interne Methode [[Delete]] false zurückgibt.

Beschreibung

Interceptions

Diese Trap kann folgende Operationen abfangen:

Den delete-Operator: delete proxy[foo] und delete proxy.foo
Reflect.deleteProperty()

Oder jede andere Operation, die die [[Delete]] interne Methode aufruft.

Invarianten

Die interne Methode [[Delete]] des Proxys wirft einen TypeError, wenn die Handler-Deklaration 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, muss die Trap einen falsy-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 Eigenschaftsdeskriptor für die Eigenschaft auf target zurückgibt, muss die Trap einen falsy-Wert zurückgeben.

Beispiele

Löschen-Operator abfangen

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

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® 2026 Language Specification # sec-proxy-object-internal-methods-and-internal-slots-delete-p