WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Function.prototype.apply — Aufruf mit einer Argumentliste

Function.prototype.apply ruft eine Funktion mit einem angegebenen this-Wert und Argumenten auf, die aus einem array-ähnlichen Objekt gelesen werden. So lässt sich eine vorbereitete Liste übergeben, statt jedes Argument einzeln anzugeben.

Version: 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 ruft eine Funktion sofort auf und gibt ihr Ergebnis zurück. In fn.apply(thisArg, argArray) legt thisArg den übergebenen this-Wert fest, während argArray die Positionsargumente bereitstellt. Im Gegensatz dazu nimmt fn.call(thisArg, a, b) die Argumente einzeln entgegen.

argArray kann ein Array oder ein array-ähnliches Objekt mit length und indizierten Eigenschaften wie 0 und 1 sein. null, undefined oder das Weglassen dieses Parameters bedeutet, dass keine Argumente übergeben werden. Die Werte werden über Indizes und nicht über einen Iterator gelesen; ein fehlender Index ergibt normalerweise undefined, kann aber vom Prototyp geerbt werden. Jeder andere primitive Wert, auch eine Zeichenkette, verursacht einen TypeError.

apply übergibt thisArg unverändert. Eine gewöhnliche Funktion außerhalb des Strict-Modus ersetzt jedoch null und undefined durch ihren globalen this-Wert und verpackt andere primitive Werte in Objekte. Eine gewöhnliche Funktion im Strict-Modus behält den übergebenen Wert bei. Pfeilfunktionen und mit bind gebundene Funktionen ignorieren diese Festlegung von this.

Im Beispiel ist args kein Array: Seine zwei Elemente werden zu den Parametern a und b, und context wird zu this. Das Ergebnis ist 15. Der Versuch, apply mit einem Empfänger zu verwenden, der nicht aufrufbar ist, verursacht einen TypeError.

Beispiele

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));

Ergebnis

15

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen