Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Reflect.apply — wywołanie funkcji z podanym this i argumentami

Reflect.apply wywołuje funkcję z podaną wartością `this` i argumentami odczytanymi z przekazanego obiektu. Zwraca wynik funkcji, nie odczytując jej właściwości `apply`.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

Reflect.apply(target, thisArgument, argumentsList)

Reflect.apply(target, thisArgument, argumentsList) wywołuje target, przekazując thisArgument jako wartość this i elementy argumentsList jako kolejne argumenty. Zwraca wynik wywołania; wyjątki są przekazywane dalej. Nie tworzy instancji i nie zastępuje operatora new.

argumentsList musi być obiektem, ale nie musi mieć właściwości length ani właściwości indeksowych. Metoda najpierw odczytuje length, a po przeliczeniu tej wartości na długość odczytuje odpowiadające jej właściwości indeksowe. Jeśli length nie istnieje, długość wynosi zero: na przykład {} jest poprawnym obiektem i nie dostarcza żadnych argumentów. Można też przekazać tablicę lub obiekt taki jak w przykładzie. Metoda nie korzysta z protokołu iteracji, więc nie rozwija elementów Set na argumenty. Odczyty właściwości mogą uruchamiać gettery.

Jeśli target nie jest wywoływalny albo argumentsList nie jest obiektem, wystąpi TypeError. W przeciwieństwie do Function.prototype.apply, pominięte argumentsList, null i undefined nie oznaczają pustej listy — przekaż []. Metoda nie odczytuje target.apply, więc działa także wtedy, gdy ta właściwość została przesłonięta.

Przekazanie thisArgument nie zmienia reguł funkcji docelowej: funkcja strzałkowa zachowuje leksykalne this, a funkcja związana przez bind zachowuje związane this. Zwykła funkcja w trybie ścisłym otrzymuje przekazaną wartość bez konwersji; poza trybem ścisłym obowiązują zwykłe reguły konwersji this.

Przykłady

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));

Wynik

15

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła