handler.has()

概要

in 操作に対するトラップです。

構文

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

引数

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

target

ターゲットオブジェクト

prop

存在を調べるためのプロパティの名称の

戻り値

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

説明

handler.has メソッドはin 操作に対するトラップです。

インターセプト

このトラップは下記の操作をインターセプトできます。:

• プロパティクエリ: foo in proxy
• 継承したプロパティクエリ: foo in Object.create(proxy)
• Object.prototype.hasOwnProperty()
• Reflect.has()

不変条件

次の不変条件に違反している場合、プロキシはTypeErrorをスローします。:

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

例

次のコードではin 操作をトラップします。

var p = new Proxy({}, {
  has: function(target, prop) {
    console.log("called: " + prop);
    return true;
  }
});

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

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

var obj = { a: 10 };
Object.preventExtensions(obj);
var p = new Proxy(obj, {
  has: function(target, prop) {
    return false;
  }
});

"a" in p; // TypeError is thrown

仕様

ブラウザ実装状況

関連情報

• Proxy
• handler
• in operator
• Reflect.has()