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
this
provided for the call totarget
. - argumentsList
- An array-like object specifying the arguments with which
target
should 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,