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.

静的な Reflect.apply() メソッドは、指定された引数とともに対象となる関数を呼び出します。

試してみましょう

構文

Reflect.apply(target, thisArgument, argumentsList)

引数

target

呼び出し対象の関数。

thisArgument

target の呼び出す際の this 値を提供する。

argumentsList

target と一緒に呼び出す引数を指定する配列風オブジェクト。

返値

指定された target 値と引数の条件で対象の関数を呼び出したときの結果です。

例外

TypeError: target が呼び出せない場合。

解説

ES5 では、ふつう Function.prototype.apply() メソッドを使用することで、指定された this の値と arguments で配列 (または 配列風オブジェクト) により引数を指定することで、関数を呼び出すことができます。

js
Function.prototype.apply.call(Math.floor, undefined, [1.75]);

Reflect.apply() を使うと、それほど冗長ではなく理解しやすくなります。

例

Reflect.apply() の使用

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, "ponies", [3]);
// "i"

仕様書

Specification
ECMAScript Language Specification
# sec-reflect.apply

ブラウザーの互換性

BCD tables only load in the browser

関連情報