CKTIS / JavaScript
Reflect.apply — een functie aanroepen met expliciete this en argumenten
Reflect.apply roept een functie aan met een opgegeven `this`-waarde en argumenten die uit een meegegeven object worden gelezen. De methode geeft het resultaat van de functie terug zonder de `apply`-eigenschap van die functie te lezen.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
Reflect.apply(target, thisArgument, argumentsList)Reflect.apply(target, thisArgument, argumentsList) roept target aan, met thisArgument als de waarde van this en de elementen van argumentsList als opeenvolgende argumenten. De methode geeft het resultaat van de aanroep terug; uitzonderingen worden doorgegeven. Ze maakt geen instantie aan en vervangt de operator new niet.
argumentsList moet een object zijn, maar hoeft geen length-eigenschap of geïndexeerde eigenschappen te hebben. De methode leest length, zet de waarde om in een lengte en leest vervolgens de bijbehorende geïndexeerde eigenschappen. Als length ontbreekt, geldt een lengte van nul: {} wordt bijvoorbeeld geaccepteerd en levert geen argumenten op. Je kunt ook een array of een object zoals in het voorbeeld doorgeven. De methode gebruikt het iteratieprotocol niet en geeft de elementen van een Set dus niet als afzonderlijke argumenten door. Het lezen van eigenschappen kan getters aanroepen.
Een niet-aanroepbare target of een argumentsList dat geen object is, veroorzaakt een TypeError. Anders dan bij Function.prototype.apply betekent een weggelaten argumentsList, null of undefined niet dat de lijst leeg is — geef [] door. De methode leest target.apply niet en werkt dus ook als die eigenschap wordt afgeschermd door een gelijknamige eigenschap.
Het meegeven van thisArgument verandert de regels van de doelfunctie niet: een arrowfunctie behoudt zijn lexicale this, en een functie die met bind is gebonden behoudt zijn gebonden this. Een gewone functie in strict mode ontvangt de opgegeven waarde ongewijzigd; buiten strict mode gelden de gebruikelijke conversieregels voor this.
Voorbeelden
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));Resultaat
15
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.