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.