Reflect.apply()

Baseline Large disponibilité

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.

Dans cet article

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

js
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"

Aider à améliorer MDN

Cette page vous a-t-elle été utile ?

Oui Non

Apprendre à contribuer

Cette page a été modifiée le 17 févr. 2025 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu