CKTIS / JavaScript
Function.prototype.apply — poziv s popisom argumenata
Function.prototype.apply poziva funkciju s navedenom vrijednošću this i argumentima pročitanima iz objekta nalik polju. Omogućuje prosljeđivanje pripremljenog popisa umjesto zasebnog navođenja svakog argumenta.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
fn.apply(thisArg, argArray)Function.prototype.apply odmah poziva funkciju i vraća njezin rezultat. U zapisu fn.apply(thisArg, argArray), thisArg određuje proslijeđenu vrijednost this, dok argArray daje pozicijske argumente. Za usporedbu, fn.call(thisArg, a, b) prima argumente pojedinačno.
argArray može biti polje ili objekt nalik polju s vrijednošću length i indeksiranim svojstvima kao što su 0 i 1. Prosljeđivanje null ili undefined, kao i izostavljanje ovog parametra, znači da nema argumenata. Vrijednosti se čitaju prema indeksu, a ne putem iteratora; indeks koji nedostaje obično daje undefined, ali može biti naslijeđen iz prototipa. Svaka druga primitivna vrijednost, uključujući niz znakova, uzrokuje TypeError.
apply prosljeđuje thisArg nepromijenjen, ali obična funkcija izvan strogog načina rada zamjenjuje null i undefined svojom globalnom vrijednošću this, a ostale primitivne vrijednosti pretvara u objekte. Obična funkcija u strogom načinu rada zadržava proslijeđenu vrijednost. Funkcije strelice i funkcije povezane pomoću bind zanemaruju ovaj odabir vrijednosti this.
U primjeru args nije polje: njegova dva elementa postaju parametri a i b, a context postaje this. Rezultat je 15. Pokušaj korištenja apply s primateljem koji se ne može pozvati uzrokuje TypeError.
Primjeri
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));Rezultat
15
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.