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

Exemple interactif

Syntaxe

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

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

Spécifications

Specification
ECMAScript Language Specification
# sec-reflect.apply

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi