CKTIS / JavaScript
Reflect.apply — извикване на функция с изрично зададени this и аргументи
Reflect.apply извиква функция с подадена стойност за `this` и аргументи, прочетени от подаден обект. Връща резултата от функцията, без да чете свойството ѝ `apply`.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
Reflect.apply(target, thisArgument, argumentsList)Reflect.apply(target, thisArgument, argumentsList) извиква target, като подава thisArgument за стойност на this, а елементите на argumentsList — като последователни аргументи. Връща резултата от извикването; изключенията се предават нататък. Не създава екземпляр и не замества оператора new.
argumentsList трябва да е обект, но не е необходимо да има свойство length или индексирани свойства. Методът прочита length, преобразува стойността в дължина и след това прочита съответните индексирани свойства. Ако length липсва, дължината се приема за нула: например {} е допустим обект и не предоставя аргументи. Може да се подаде и масив или обект като този в примера. Методът не използва протокола за итерация и затова не подава елементите на Set като отделни аргументи. Четенето на свойства може да задейства гетъри.
Ако target не може да бъде извикан или argumentsList не е обект, възниква TypeError. За разлика от Function.prototype.apply, пропуснат argumentsList, null или undefined не означават празен списък — подайте []. Методът не чете target.apply, затова работи и когато това свойство е засенчено.
Подаването на thisArgument не променя правилата на целевата функция: стрелкова функция запазва лексикалното си this, а функция, свързана чрез bind, запазва свързаното си this. Обикновена функция в строг режим получава подадената стойност без промяна; извън строг режим важат обичайните правила за преобразуване на this.
Примери
function total(a, b) {
"use strict";
return this.base + a + b;
}
const receiver = { base: 10 };
const args = { 0: 2, 1: 3, length: 2 };
console.log(Reflect.apply(total, receiver, args));Резултат
15
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.