Reflect.apply() - JavaScript

Reflect.apply() - JavaScript | MDN

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 statique Reflect.apply() permet d'appeler une fonction cible avec des arguments donnés.

Exemple interactif

console.log(Reflect.apply(Math.floor, undefined, [1.75]));
// Expected output: 1

console.log(
  Reflect.apply(String.fromCharCode, undefined, [104, 101, 108, 108, 111]),
);
// Expected output: "hello"

console.log(
  Reflect.apply(RegExp.prototype.exec, /ab/, ["confabulation"]).index,
);
// Expected output: 4

console.log(Reflect.apply("".charAt, "ponies", [3]));
// Expected output: "i"

Syntaxe

Reflect.apply(cible, argumentThis, listeArguments);

Paramètres

cible: La fonction cible à appeler.
argumentThis: La valeur fournie pour this lors de l'appel à cible.
listeArguments: Un objet semblable à un tableau qui définit les arguments à passer à cible. S'il vaut null ou undefined, aucun argument ne sera passé.

Valeur de retour

Le résultat de l'appel de la fonction cible indiquée avec la valeur this et les arguments indiqués.

Exceptions levées

Une exception TypeError, si cible ne peut pas être appelée.

Description

Avec ES5, on utilise généralement Function.prototype.apply() pour appeler une fonction avec une valeur this donnée et des arguments donnés.

Function.prototype.apply.call(Math.floor, undefined, [1.75]);

Reflect.apply permet de rendre cela plus concis et facile à comprendre.

Exemples

Reflect.apply(Math.floor, undefined, [1.75]);
// 1;

Reflect.apply(String.fromCharCode, undefined, [104, 101, 108, 108, 111]);
// "hello"

Reflect.apply(RegExp.prototype.exec, /ab/, ["confabulation"]).index;
// 4

Reflect.apply("".charAt, "poneys", [3]);
// "e"

Spécifications

Specification
ECMAScript® 2026 Language Specification # sec-reflect.apply