База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници