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 Methode handler.deleteProperty() ist eine Trap für die [[Delete]] interne Methode des Objekts, 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
new Proxy(target, {
deleteProperty(target, property) {
}
})
Parameter
Die folgenden Parameter werden an die Methode deleteProperty() übergeben. this ist an den Handler gebunden.
Rückgabewert
Die Methode deleteProperty() muss einen Boolean zurückgeben, der 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 mode, werfen einen TypeError, wenn die interne Methode [[Delete]] false zurückgibt.
Beschreibung
>Interceptions
Diese Trap kann die folgenden Operationen abfangen:
- Der
delete-Operator:delete proxy[foo]unddelete proxy.foo Reflect.deleteProperty()
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 bedeutet, wenn
Reflect.getOwnPropertyDescriptor()für die Eigenschaft auftargetconfigurable: falsezurü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 bedeutet, wenn
Reflect.isExtensible()auftargetfalsezurückgibt undReflect.getOwnPropertyDescriptor()einen Eigenschaftsdeskriptor für die Eigenschaft auftargetzurückgibt, muss die Trap einen falsy-Wert zurückgeben.
Beispiele
>Abfangen des delete-Operatos
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
| Spezifikation |
|---|
| ECMAScript® 2027 Language Specification> # sec-proxy-object-internal-methods-and-internal-slots-delete-p> |