CKTIS / JavaScript
Reflect.apply — appeler une fonction avec un this et des arguments explicites
Reflect.apply appelle une fonction avec une valeur de `this` fournie et des arguments lus dans un objet passé en paramètre. La méthode renvoie le résultat de la fonction sans lire la propriété `apply` de celle-ci.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
Reflect.apply(target, thisArgument, argumentsList)Reflect.apply(target, thisArgument, argumentsList) appelle target, en fournissant thisArgument comme valeur de this et les éléments de argumentsList comme arguments successifs. La méthode renvoie le résultat de l’appel ; les exceptions sont propagées. Elle ne crée pas d’instance et ne remplace pas l’opérateur new.
argumentsList doit être un objet, mais il n’a pas besoin de posséder une propriété length ni de propriétés indexées. La méthode lit length, convertit sa valeur en longueur, puis lit les propriétés indexées correspondantes. Si length est absente, la longueur est considérée comme nulle : par exemple, {} est accepté et ne fournit aucun argument. On peut aussi passer un tableau ou un objet comme celui de l’exemple. La méthode n’utilise pas le protocole d’itération et ne passe donc pas les éléments d’un Set comme arguments distincts. La lecture des propriétés peut déclencher des getters.
Si target n’est pas appelable ou si argumentsList n’est pas un objet, un TypeError est déclenché. Contrairement à Function.prototype.apply, omettre argumentsList ou fournir null ou undefined ne signifie pas que la liste est vide — passez []. La méthode ne lit pas target.apply ; elle fonctionne donc aussi lorsque cette propriété a été masquée.
Fournir thisArgument ne modifie pas les règles de la fonction cible : une fonction fléchée conserve son this lexical, et une fonction liée avec bind conserve son this lié. Une fonction ordinaire en mode strict reçoit la valeur fournie sans modification ; hors du mode strict, les règles habituelles de conversion de this s’appliquent.
Exemples
function total(a, b) {
"use strict";
return this.base + a + b;
}
const receiver = { base: 10 };
const args = { 0: 2, 1: 3, length: 2 };
console.log(Reflect.apply(total, receiver, args));Résultat
15
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.