handler.has()

¥Syntax

new Proxy(target, {
  has(target, prop) {
  }
});

¥Parameters

以下参数传递给 has() 方法。this 绑定到处理程序。

¥The following parameters are passed to has() method. this is bound to the handler.

target

目标对象。

prop

要检查是否存在的属性的名称或 Symbol。

¥Return value

has() 方法必须返回布尔值。

¥The has() method must return a boolean value.

¥Description

¥Interceptions

该陷阱可以拦截以下操作：

¥This trap can intercept these operations:

• in 运算符：foo in proxy
• with 检查：with(proxy) { (foo); }
• Reflect.has()

或调用 [[HasProperty]] 内部方法 的任何其他操作。

¥Or any other operation that invokes the [[HasProperty]] internal method.

¥Invariants

如果违反以下不变量，则陷阱在调用时会抛出 TypeError。

¥If the following invariants are violated, the trap throws a TypeError when invoked.

• 如果属性作为目标对象的不可配置自有属性存在，则不能将其报告为不存在。
• 如果属性作为目标对象自己的属性存在并且目标对象不可扩展，则不能将其报告为不存在。

¥Examples

¥Trapping the in operator

以下代码捕获 in 运算符。

¥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.

const obj = { a: 10 };
Object.preventExtensions(obj);

const p = new Proxy(obj, {
  has(target, prop) {
    return false;
  },
});

"a" in p; // TypeError is thrown

¥See also

• Proxy
• Proxy() 构造函数
• in
• Reflect.has()