CKTIS / JavaScript
Function.prototype.apply — volání se seznamem argumentů
Function.prototype.apply zavolá funkci s předanou hodnotou this a argumenty načtenými z objektu podobného poli. Umožňuje předat připravený seznam místo vypisování jednotlivých argumentů.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
fn.apply(thisArg, argArray)Function.prototype.apply ihned zavolá funkci a vrátí její výsledek. V zápisu fn.apply(thisArg, argArray) určuje thisArg předanou hodnotu this, zatímco argArray poskytuje poziční argumenty. Naproti tomu fn.call(thisArg, a, b) přijímá argumenty jednotlivě.
argArray může být pole nebo objekt podobný poli s vlastností length a indexovanými vlastnostmi, například 0 a 1. Předání null, předání undefined nebo vynechání tohoto parametru znamená, že nejsou žádné argumenty. Hodnoty se čtou podle indexů, nikoli pomocí iterátoru; chybějící index obvykle poskytne undefined, ale může být zděděn z prototypu. Jakákoli jiná primitivní hodnota, včetně řetězce, způsobí TypeError.
apply předává thisArg beze změny, ale běžná funkce mimo striktní režim nahrazuje null a undefined svou globální hodnotou this a ostatní primitivní hodnoty zabalí do objektů. Běžná funkce ve striktním režimu předanou hodnotu zachová. Funkce šipky a funkce svázané pomocí bind tuto volbu hodnoty this ignorují.
V příkladu args není pole: jeho dva prvky se stanou parametry a a b a context se stane hodnotou this. Výsledkem je 15. Pokus použít apply s příjemcem, který není volatelný, způsobí TypeError.
Pří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ýsledek
15
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.