handler.has()

次の引数は has() メソッドに渡されます。 this はハンドラーにバインドされます。

target

ターゲットオブジェクトです。

prop

存在を確認するプロパティ名です。

has メソッドは論理値を返さなければなりません。

このトラップは下記の操作に介入できます。

• in 演算子: foo in proxy
• with チェック: with(proxy) { (foo); }
• Reflect.has()

他にも、[[HasProperty]] 内部メソッドを呼び出すあらゆる操作に介入できます。

以下の不変条件に違反している場合、プロキシーは TypeError を発生します。

• プロパティがターゲットオブジェクトの設定不可の独自プロパティとして存在する場合、存在しないとして報告されてはいけません。
• プロパティがターゲットオブジェクトの独自プロパティとして存在し、そのターゲットオブジェクトが拡張不可の場合、存在しないとして報告されてはいけません。

次のコードでは in 演算子をトラップします。

const p = new Proxy(
  {},
  {
    has(target, prop) {
      console.log(`called: ${prop}`);
      return true;
    },
  },
);

console.log("a" in p);
// "called: a"
// true

次のコードでは不変条件に違反します。

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

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

"a" in p; // TypeError is thrown

• Proxy
• Proxy() コンストラクター
• in 演算子
• Reflect.has()