Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Reflect.apply — klic funkcije z izrecno podanima this in argumenti

Reflect.apply pokliče funkcijo s podano vrednostjo `this` in argumenti, prebranimi iz podanega objekta. Vrne rezultat funkcije, ne da bi prebral njeno lastnost `apply`.

Različica: 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) pokliče target; thisArgument poda kot vrednost this, elemente argumentsList pa kot zaporedne argumente. Vrne rezultat klica; izjeme se posredujejo naprej. Ne ustvari primerka in ne nadomesti operatorja new.

argumentsList mora biti objekt, ni pa nujno, da ima lastnost length ali indeksirane lastnosti. Metoda prebere length, vrednost pretvori v dolžino in nato prebere ustrezne indeksirane lastnosti. Če length manjka, se uporabi dolžina nič: {} je na primer veljaven objekt in ne poda nobenega argumenta. Podaš lahko tudi polje ali objekt, kakršen je v primeru. Metoda ne uporablja iteracijskega protokola, zato elementov Set ne poda kot posameznih argumentov. Branje lastnosti lahko sproži getterje.

Če target ni klicljiv ali argumentsList ni objekt, pride do napake TypeError. V nasprotju z Function.prototype.apply izpuščen argumentsList, null ali undefined ne pomenijo praznega seznama — podaj []. Metoda ne bere target.apply, zato deluje tudi, če je bila ta lastnost prekrita.

Podajanje thisArgument ne spremeni pravil ciljne funkcije: puščična funkcija ohrani leksikalni this, funkcija, vezana z bind, pa ohrani vezani this. Običajna funkcija v strogem načinu prejme podano vrednost nespremenjeno; zunaj strogega načina veljajo običajna pravila pretvorbe this.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri