CKTIS / JavaScript
Reflect.apply — pozivanje funkcije s izričitim this i argumentima
Reflect.apply poziva funkciju sa zadanom vrijednošću `this` i argumentima pročitanima iz proslijeđenog objekta. Vraća rezultat funkcije bez čitanja njezina svojstva `apply`.
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
Reflect.apply(target, thisArgument, argumentsList)Reflect.apply(target, thisArgument, argumentsList) poziva target, pri čemu thisArgument prosljeđuje kao vrijednost this, a elemente argumentsList kao uzastopne argumente. Vraća rezultat poziva; iznimke se prosljeđuju dalje. Ne stvara instancu niti zamjenjuje operator new.
argumentsList mora biti objekt, ali ne mora imati svojstvo length ni indeksirana svojstva. Metoda čita length, pretvara vrijednost u duljinu i zatim čita odgovarajuća indeksirana svojstva. Ako length nedostaje, duljina se smatra nulom: primjerice, {} je prihvatljiv objekt i ne daje nijedan argument. Možeš proslijediti i niz ili objekt poput onoga u primjeru. Metoda ne koristi iteracijski protokol pa elemente skupa Set ne prosljeđuje kao pojedinačne argumente. Čitanje svojstava može pozvati gettere.
Ako target nije pozivljiv ili argumentsList nije objekt, dolazi do pogreške TypeError. Za razliku od Function.prototype.apply, izostavljeni argumentsList, null ili undefined ne znače prazan popis — proslijedi []. Metoda ne čita target.apply, pa radi i kada je to svojstvo zasjenjeno.
Prosljeđivanje thisArgument ne mijenja pravila ciljne funkcije: strelična funkcija zadržava svoj leksički this, a funkcija vezana s pomoću bind zadržava svoj vezani this. Obična funkcija u strogom načinu rada prima proslijeđenu vrijednost nepromijenjenu; izvan strogog načina rada vrijede uobičajena pravila pretvorbe this.
Primjeri
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));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.