handler.has()
The handler.has() method is a trap for the [[HasProperty]] object internal method, which is used by operations such as the in operator.
The handler.has() method is a trap for the [[HasProperty]] object internal method, which is used by operations such as the in operator.
taller
```js interactive-example 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
```js-nolint
new Proxy(target, {
has(target, property) {
}
})
Parameters
The following parameters are passed to has() method. this is bound to the handler.
target- : The target object.
property- : A string or Symbol representing the property name.
Return value
The has() method must return a Boolean indicating whether or not the property exists. Other values are coerced to booleans.
Description
Interceptions
This trap can intercept these operations:
Or any other operation that invokes the [[HasProperty]] internal method.
Invariants
The proxy's [[HasProperty]] internal method throws a TypeError if the handler definition violates one of the following invariants:
- A property cannot be reported as non-existent, if it exists as a non-configurable own property of the target object. That is, if Reflect.getOwnPropertyDescriptor() returns
configurable: falsefor the property ontarget, the trap must returntrue. - A property cannot be reported as non-existent, if it exists as an own property of the target object and the target object is not extensible. That is, if Reflect.isExtensible() returns
falseontarget, and Reflect.getOwnPropertyDescriptor() returns a property descriptor for the property ontarget, the trap must returntrue.
Examples
Trapping the in operator
The following code traps the in operator.
const p = new Proxy(
{},
{
has(target, prop) {
console.log(`called: ${prop}`);
return true;
},
},
);
console.log("a" in p);
// "called: a"
// true
The following code violates an invariant.
```js example-bad const obj = { a: 10 }; Object.preventExtensions(obj);
const p = new Proxy(obj, { has(target, prop) { return false; }, });
"a" in p; // TypeError is thrown ```
Specifications
Browser compatibility
See also
- Proxy
Proxy()constructor- in
- Reflect.has()