handler.apply()

¥Syntax

new Proxy(target, {
  apply(target, thisArg, argumentsList) {
  }
});

¥Parameters

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

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

target

目标可调用对象。

thisArg

调用的 this 参数。

argumentsList

调用的参数列表。

¥Return value

apply() 方法可以返回任何值。

¥The apply() method can return any value.

¥Description

¥Interceptions

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

¥This trap can intercept these operations:

• 函数调用：proxy(...args)
• Function.prototype.apply() and Function.prototype.call()
• Reflect.apply()

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

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

¥Invariants

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

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

• target 本身必须是可调用的。也就是说，它必须是一个函数对象。

¥Examples

¥Trapping a function call

以下代码捕获函数调用。

¥The following code traps a function call.

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

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

¥See also

• Proxy
• Proxy() 构造函数
• Function.prototype.apply()
• Function.prototype.call()
• Reflect.apply()