Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Reflect.apply — volanie funkcie s výslovne určeným this a argumentmi

Reflect.apply zavolá funkciu s odovzdanou hodnotou `this` a argumentmi načítanými z odovzdaného objektu. Vráti výsledok funkcie bez čítania jej vlastnosti `apply`.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

Reflect.apply(target, thisArgument, argumentsList)

Reflect.apply(target, thisArgument, argumentsList) zavolá target; thisArgument odovzdá ako hodnotu this a prvky argumentsList ako po sebe nasledujúce argumenty. Vráti výsledok volania; výnimky sa šíria ďalej. Nevytvára inštanciu a nenahrádza operátor new.

argumentsList musí byť objekt, ale nemusí mať vlastnosť length ani indexované vlastnosti. Metóda načíta length, prevedie jej hodnotu na dĺžku a potom načíta zodpovedajúce indexované vlastnosti. Ak length chýba, použije sa nulová dĺžka: napríklad {} je platný objekt a neposkytne žiadne argumenty. Možno odovzdať aj pole alebo objekt ako v príklade. Metóda nepoužíva iteračný protokol, takže prvky Set neodovzdá ako jednotlivé argumenty. Čítanie vlastností môže spustiť gettery.

Ak target nie je volateľný alebo argumentsList nie je objekt, dôjde k chybe TypeError. Na rozdiel od Function.prototype.apply vynechané argumentsList, null ani undefined neznamenajú prázdny zoznam — odovzdajte []. Metóda nečíta target.apply, takže funguje aj vtedy, keď bola táto vlastnosť prekrytá.

Odovzdanie thisArgument nemení pravidlá cieľovej funkcie: šípková funkcia si zachová lexikálne this a funkcia zviazaná pomocou bind si zachová zviazané this. Bežná funkcia v strict režime dostane odovzdanú hodnotu bez zmeny; mimo strict režimu platia obvyklé pravidlá konverzie this.

Príklady

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));

Výsledok

15

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje