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

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

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® 2025 Language Specification
# sec-reflect.apply

Compatibilité des navigateurs

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
apply

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Voir aussi