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.