CKTIS / JavaScript
Function.prototype.apply — wywołanie z listą argumentów
Function.prototype.apply wywołuje funkcję z podaną wartością this i argumentami odczytanymi z obiektu tablicopodobnego. Pozwala przekazać przygotowaną listę zamiast wypisywać argumenty osobno.
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
fn.apply(thisArg, argArray)Function.prototype.apply wywołuje funkcję od razu i zwraca jej wynik. W zapisie fn.apply(thisArg, argArray) parametr thisArg określa przekazywaną wartość this, a argArray dostarcza argumenty pozycyjne. Dla porównania fn.call(thisArg, a, b) przyjmuje argumenty osobno.
argArray może być tablicą lub obiektem tablicopodobnym z length i właściwościami indeksowymi, takimi jak 0 i 1. null, undefined lub pominięcie tego parametru oznacza brak argumentów. Odczyt odbywa się według indeksów, nie przez iterator; brakujący indeks zwykle daje undefined, ale może zostać odczytany z prototypu. Inna wartość pierwotna, również tekst, powoduje TypeError.
apply przekazuje thisArg bez zmiany, ale zwykła funkcja poza trybem ścisłym zamienia null i undefined na globalną wartość this, a pozostałe wartości pierwotne opakowuje w obiekty. Zwykła funkcja w trybie ścisłym zachowuje przekazaną wartość. Funkcje strzałkowe i funkcje związane przez bind ignorują ten wybór this.
W przykładzie args nie jest tablicą: jego dwa elementy stają się parametrami a i b, a context staje się this. Wynik to 15. Próba użycia apply z odbiorcą, który nie jest wywoływalny, powoduje TypeError.
Przykłady
function total(a, b) {
"use strict";
return this.base + a + b;
}
const context = { base: 10 };
const args = { 0: 2, 1: 3, length: 2 };
console.log(total.apply(context, args));Wynik
15
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.