Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje