The static Reflect.apply() method calls a target function with arguments as specified.
Syntax
Reflect.apply(target, thisArgument, argumentsList)
Parameters
- target
- The target function to call.
- thisArgument
- The value of
thisprovided for the call totarget. - argumentsList
- An array-like object specifying the arguments with which
targetshould be called.
Return value
The result of calling the given target function with the specified this value and arguments.
Exceptions
A TypeError, if the target is not callable.
Description
In ES5, you typically use the Function.prototype.apply() method to call a function with a given this value and arguments provided as an array (or an array-like object).
Function.prototype.apply.call(Math.floor, undefined, [1.75]);
With Reflect.apply this becomes less verbose and easier to understand.
Examples
Using Reflect.apply()
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, 'ponies', [3]);
// "i"
Specifications
| Specification | Status | Comment |
|---|---|---|
| ECMAScript 2015 (6th Edition, ECMA-262) The definition of 'Reflect.apply' in that specification. |
Standard | Initial definition. |
| ECMAScript Latest Draft (ECMA-262) The definition of 'Reflect.apply' in that specification. |
Draft |
Browser compatibility
| Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| Basic support | 49 | 12 | 42 (42) | No support | 36 | 10 |
| Feature | Android | Chrome for Android | Edge | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|---|
| Basic support | No support | 49 | (Yes) | 42.0 (42) | No support | No support | 10 |
See also
Document Tags and Contributors
Tags:
Contributors to this page:
jameshkramer,
nmve,
kdex,
David_Gilbertson,
eduardoboucas,
gingerik,
fscholz,
Waldo,
talha2k
Last updated by:
jameshkramer,