Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

handler.deleteProperty()

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2016 browserübergreifend verfügbar.

Die handler.deleteProperty() Methode ist eine Falle für die [[Delete]] interne Objektmethode, die von Operationen wie dem delete Operator verwendet wird.

Probieren Sie es aus

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

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

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

const proxy = new Proxy(monster, handler);
delete proxy.texture;

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

Syntax

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

Parameter

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

target

Das Zielobjekt.

property

Ein String oder Symbol, der den Eigenschaftsnamen darstellt.

Rückgabewert

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

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

Beschreibung

Abfangvorgänge

Diese Falle kann folgende Operationen abfangen:

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

Invarianten

Die [[Delete]] interne Methode des Proxys wirft einen TypeError, wenn die Definition des Handlers 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() configurable: false für die Eigenschaft auf target zurückgibt, dann muss die Falle einen nicht-truthy 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() false auf target zurückgibt, und Reflect.getOwnPropertyDescriptor() einen Eigenschaftsdeskriptor für die Eigenschaft auf target zurückgibt, dann muss die Falle einen nicht-truthy Wert zurückgeben.

Beispiele

Abfangen des delete Operators

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

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

Browser-Kompatibilität

Siehe auch