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

CKTIS / JavaScript

Reflect.apply — volání funkce s výslovně určeným this a argumenty

Reflect.apply zavolá funkci s předanou hodnotou `this` a argumenty načtenými z předaného objektu. Vrátí výsledek funkce, aniž by četla její vlastnost `apply`.

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

Reflect.apply(target, thisArgument, argumentsList)

Reflect.apply(target, thisArgument, argumentsList) zavolá target; thisArgument předá jako hodnotu this a prvky argumentsList jako po sobě jdoucí argumenty. Vrátí výsledek volání; výjimky se předávají dál. Nevytváří instanci a nenahrazuje operátor new.

argumentsList musí být objekt, ale nemusí mít vlastnost length ani indexované vlastnosti. Metoda načte length, převede její hodnotu na délku a poté načte odpovídající indexované vlastnosti. Pokud length chybí, použije se délka nula: například {} je platný objekt a neposkytne žádné argumenty. Lze předat také pole nebo objekt jako v příkladu. Metoda nepoužívá iterační protokol, takže prvky Set nepředává jako jednotlivé argumenty. Čtení vlastností může spustit gettery.

Pokud target nelze volat nebo argumentsList není objekt, dojde k chybě TypeError. Na rozdíl od Function.prototype.apply neznamená vynechané argumentsList, null ani undefined prázdný seznam — předejte []. Metoda nečte target.apply, takže funguje i tehdy, když byla tato vlastnost zastíněna.

Předání thisArgument nemění pravidla cílové funkce: šipková funkce si zachová lexikální this a funkce svázaná pomocí bind si zachová svázané this. Běžná funkce ve striktním režimu obdrží předanou hodnotu beze změny; mimo striktní režim platí obvyklá pravidla převodu this.

Pří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ý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