Proxy.handler.apply

The handler.apply() method is a trap for a function call.

Syntax

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

Parameters

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

target

The target object.

thisArg

The this argument for the call.

argumentsList

The list of arguments for the call.

Return value

The apply method can return any value.

Description

The handler.apply method is a trap for a function call.

Interceptions

This trap can intercept these operations:

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

Invariants

There are no invariants for the handler.apply method.

Examples

The following code traps a function call.

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

Specifications

Specification	Status	Comment
ECMAScript 2015 (6th Edition, ECMA-262) The definition of '[[Call]]' in that specification.	Standard	Initial definition.
ECMAScript 2017 Draft (ECMA-262) The definition of '[[Call]]' in that specification.	Draft

Browser compatibility

See also

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