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.