handler.has()
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.has() Methode ist eine Falle für die [[HasProperty]] Objekt-internen Methode, die von Operationen wie dem in Operator verwendet wird.
Probieren Sie es aus
const handler = {
has(target, key) {
if (key[0] === "_") {
return false;
}
return key in target;
},
};
const monster = {
_secret: "easily scared",
eyeCount: 4,
};
const proxy = new Proxy(monster, handler);
console.log("eyeCount" in proxy);
// Expected output: true
console.log("_secret" in proxy);
// Expected output: false
console.log("_secret" in monster);
// Expected output: true
Syntax
new Proxy(target, {
has(target, property) {
}
})
Parameter
Die folgenden Parameter werden an die has() Methode übergeben. this ist an den Handler gebunden.
Rückgabewert
Die has() Methode muss einen Boolean zurückgeben, der anzeigt, ob die Eigenschaft existiert oder nicht. Andere Werte werden zu Booleans konvertiert.
Beschreibung
>Abfangvorgänge
Diese Falle kann folgende Operationen abfangen:
- Der
inOperator:foo in proxy withÜberprüfung:with(proxy) { (foo); }Reflect.has()
Oder jede andere Operation, die die [[HasProperty]] interne Methode aufruft.
Invarianten
Die [[HasProperty]] interne Methode des Proxys wirft einen TypeError, wenn die Handler-Definition eine der folgenden Invarianten verletzt:
- Eine Eigenschaft kann nicht als nicht existent gemeldet werden, wenn sie als nicht-konfigurierbare eigene Eigenschaft des Zielobjekts existiert. Das bedeutet, wenn
Reflect.getOwnPropertyDescriptor()configurable: falsefür die Eigenschaft auftargetzurückgibt, muss die Falletruezurückgeben. - Eine Eigenschaft kann nicht als nicht existent gemeldet werden, wenn sie als eigene Eigenschaft des Zielobjekts existiert und das Zielobjekt nicht erweiterbar ist. Das bedeutet, wenn
Reflect.isExtensible()falsefürtargetzurückgibt undReflect.getOwnPropertyDescriptor()einen Eigenschafts-Deskriptor für die Eigenschaft auftargetzurückgibt, muss die Falletruezurückgeben.
Beispiele
>Abfangen des in Operators
Der folgende Code fängt den in Operator ab.
const p = new Proxy(
{},
{
has(target, prop) {
console.log(`called: ${prop}`);
return true;
},
},
);
console.log("a" in p);
// "called: a"
// true
Der folgende Code verletzt eine Invariante.
const obj = { a: 10 };
Object.preventExtensions(obj);
const p = new Proxy(obj, {
has(target, prop) {
return false;
},
});
"a" in p; // TypeError is thrown
Spezifikationen
| Specification |
|---|
| ECMAScript® 2026 Language Specification> # sec-proxy-object-internal-methods-and-internal-slots-hasproperty-p> |