Reflect.apply()

Статический метод Reflect.apply() вызывает целевую функцию с указанными аргументами.

Попробуйте

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"

Синтаксис

Reflect.apply(target, thisArgument, argumentsList)

Параметры

target

Целевая функция для вызова.

thisArgument

Значение this, предоставленное для вызова target.

argumentsList

Объект, похожий на массив, указывающий аргументы, с которыми должен быть вызван target.

Возвращаемое значение

Результат вызова данной функции target с указанным значением this и аргументами.

Исключения

TypeError

Выбрасывается, если target не является функцией или argumentsList не является объектом.

Описание

Reflect.apply() обеспечивает рефлексивную семантику вызова функции. То есть, Reflect.apply(target, thisArgument, argumentsList) семантически эквивалентен:

Math.floor.apply(null, [1.75]);
Reflect.apply(Math.floor, null, [1.75]);

Единственные различия:

• Reflect.apply() принимает функцию для вызова в качестве параметра target, а не в контексте this.
• Reflect.apply() выбрасывает исключение, если argumentsList опущен, вместо того чтобы по умолчанию вызывать функцию без параметров.

Reflect.apply() вызывает внутренний метод объекта [[Call]] для target.

Примеры

Использование 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"

Спецификации

Совместимость с браузерами

Смотрите также

• Полифил Reflect.apply в core-js
• es-shims полифил Reflect.apply
• Reflect
• Function.prototype.apply()
• handler.apply()