handler.apply()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2016.

La méthode handler.apply() représente une trappe pour un appel de fonctions.

Exemple interactif

function sum(a, b) {
  return a + b;
}

const handler = {
  apply: function (target, thisArg, argumentsList) {
    console.log(`Calculate sum: ${argumentsList}`);
    // Expected output: "Calculate sum: 1,2"

    return target(argumentsList[0], argumentsList[1]) * 10;
  },
};

const proxy1 = new Proxy(sum, handler);

console.log(sum(1, 2));
// Expected output: 3
console.log(proxy1(1, 2));
// Expected output: 30

Syntaxe

var p = new Proxy(cible, {
  apply: function (cible, thisArg, listeArguments) {},
});

Paramètres

Les paramètres suivants sont passés à la méthode apply. Ici, this est lié au gestionnaire.

cible: L'objet cible.
thisArg: L'argument this pour cet appel.
listeArguments: La liste d'arguments pour l'appel.

Valeur de retour

La méthode apply peut renvoyer n'importe quelle valeur.

Description

La méthode handler.apply est une trappe pour l'appel à une fonction.

Interceptions

Cette trappe intercepte les opérations suivantes :

proxy(...args)
Function.prototype.apply() et Function.prototype.call()
Reflect.apply()

Invariants

Si les invariants suivants ne sont pas respectés, le proxy lèvera une exception TypeError :

la cible doit pouvoir être « appelable ». Autrement dit, il doit s'agir d'une fonction.

Exemples

Dans l'exemple ci-dessous, on piège un appel de fonction.

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

Spécifications

Specification
ECMAScript® 2026 Language Specification # sec-proxy-object-internal-methods-and-internal-slots-call-thisargument-argumentslist