handler.apply()

handler.apply() メソッドは関数呼び出しに対するトラップです。

構文

var p = new Proxy(target, {
  apply: function(target, thisArg, argumentsList) {
  }
});

引数

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

target

ターゲットオブジェクト

thisArg

呼び出しに対するthis引数

argumentsList

呼び出しに対する引数リスト

戻り値

apply メソッドはどんな値でも返すことができます。

説明

handler.apply メソッドは関数呼び出しに対するトラップです。

インターセプト

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

• proxy(..args)
• Function.prototype.apply()、Function.prototype.call()
• Reflect.apply()

不変条件

以下の不変条件が守られていない場合、TypeErrorが投げられます。

target は呼び出し可能、つまり関数でなければなりません。

例

次のコードでは、関数呼び出しをトラップします。

var p = new Proxy(function() {}, {
  apply: function(target, thisArg, argumentsList) {
    console.log("called: " + argumentsList.join(", "));
    return argumentsList[0] + argumentsList[1] + argumentsList[2];
  }
});

console.log(p(1, 2, 3)); // "called: 1, 2, 3"
                         // 6

仕様

ブラウザ実装状況

関連情報

• Proxy
• handler
• Function.prototype.apply
• Function.prototype.call
• Reflect.apply()