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 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
new Proxy(target, {
deleteProperty(target, property) {
}
})
Parameter
Die folgenden Parameter werden an die deleteProperty()
Methode übergeben. this
ist an den Handler gebunden.
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:
- 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 heißt, wenn
Reflect.getOwnPropertyDescriptor()
configurable: false
für die Eigenschaft auftarget
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
auftarget
zurückgibt, undReflect.getOwnPropertyDescriptor()
einen Eigenschaftsdeskriptor für die Eigenschaft auftarget
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.
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> |
Browser-Kompatibilität
Loading…