handler.has()

const p = new Proxy(target, {
  has: function(target, prop) {
  }
});

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

target

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

prop

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

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

handler.has() メソッドは in 演算子に対するトラップです。

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

• プロパティクエリ: foo in proxy
• 継承したプロパティクエリ: foo in Object.create(proxy)
• with チェック: with(proxy) { (foo); }
• Reflect.has()

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

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

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

const p = new Proxy({}, {
  has: function(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: function(target, prop) {
    return false;
  }
});

'a' in p; // TypeError is thrown

• Proxy
• handler
• in 演算子
• Reflect.has()