CKTIS / JavaScript
Function.prototype.apply — aanroepen met een argumentenlijst
Function.prototype.apply roept een functie aan met een opgegeven this-waarde en argumenten die uit een array-achtig object worden gelezen. Zo kun je een voorbereide lijst doorgeven in plaats van elk argument afzonderlijk te schrijven.
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
fn.apply(thisArg, argArray)Function.prototype.apply roept een functie direct aan en geeft het resultaat terug. In fn.apply(thisArg, argArray) bepaalt thisArg de opgegeven this-waarde, terwijl argArray de positionele argumenten levert. Ter vergelijking: fn.call(thisArg, a, b) neemt de argumenten afzonderlijk aan.
argArray kan een array zijn of een array-achtig object met length en geïndexeerde eigenschappen zoals 0 en 1. null of undefined doorgeven, of deze parameter weglaten, betekent dat er geen argumenten zijn. Waarden worden op index gelezen, niet via een iterator; een ontbrekende index levert meestal undefined op, maar kan ook van het prototype worden overgenomen. Elke andere primitieve waarde, waaronder een tekenreeks, veroorzaakt een TypeError.
apply geeft thisArg ongewijzigd door, maar een gewone functie buiten de strict-modus vervangt null en undefined door de globale this-waarde en verpakt andere primitieve waarden in objecten. Een gewone functie in strict-modus behoudt de opgegeven waarde. Pijlfuncties en functies die met bind zijn gebonden, negeren deze keuze van this.
In het voorbeeld is args geen array: de twee elementen worden de parameters a en b, en context wordt this. Het resultaat is 15. apply gebruiken met een ontvanger die niet aanroepbaar is, veroorzaakt een TypeError.
Voorbeelden
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));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.