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

CKTIS / JavaScript

Function.prototype.apply — volanie so zoznamom argumentov

Function.prototype.apply zavolá funkciu s určenou hodnotou this a argumentmi načítanými z objektu podobného poľu. Umožňuje odovzdať pripravený zoznam namiesto vypisovania jednotlivých argumentov.

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

fn.apply(thisArg, argArray)

Function.prototype.apply okamžite zavolá funkciu a vráti jej výsledok. V zápise fn.apply(thisArg, argArray) určuje thisArg odovzdanú hodnotu this, zatiaľ čo argArray poskytuje pozičné argumenty. Na porovnanie, fn.call(thisArg, a, b) prijíma argumenty jednotlivo.

argArray môže byť pole alebo objekt podobný poľu s vlastnosťou length a indexovanými vlastnosťami, napríklad 0 a 1. Odovzdanie null, odovzdanie undefined alebo vynechanie tohto parametra znamená, že nie sú žiadne argumenty. Hodnoty sa čítajú podľa indexov, nie pomocou iterátora; chýbajúci index zvyčajne poskytne undefined, ale môže byť zdedený z prototypu. Akákoľvek iná primitívna hodnota vrátane reťazca spôsobí TypeError.

apply odovzdáva thisArg bez zmeny, ale bežná funkcia mimo prísneho režimu nahrádza null a undefined svojou globálnou hodnotou this a ostatné primitívne hodnoty obaľuje do objektov. Bežná funkcia v prísnom režime odovzdanú hodnotu zachová. Funkcie šípky a funkcie zviazané pomocou bind túto voľbu hodnoty this ignorujú.

V príklade args nie je pole: jeho dva prvky sa stanú parametrami a a b a context sa stane hodnotou this. Výsledkom je 15. Pokus použiť apply s príjemcom, ktorý nie je volateľný, spôsobí TypeError.

Príklady

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

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