handler.apply()
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis septembre 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
thispour 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()etFunction.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 |