Get to know MDN better
Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Die apply() Methode von Function Instanzen ruft diese Funktion mit einem gegebenen this-Wert und arguments, die als Array (oder ein array-ähnliches Objekt) bereitgestellt werden, auf.
Der Wert von this, der für den Aufruf von func bereitgestellt wird. Wenn die Funktion nicht im strict mode ist, werden null und undefined durch das globale Objekt ersetzt, und primitive Werte werden in Objekte umgewandelt.
argsArray OptionalEin array-ähnliches Objekt, das die Argumente angibt, mit denen func aufgerufen werden soll, oder null oder undefined, wenn keine Argumente an die Funktion übergeben werden sollen.
Das Ergebnis des Aufrufs der Funktion mit dem angegebenen this-Wert und den Argumenten.
Hinweis: Diese Funktion ist fast identisch mit call(), außer dass die Funktionsargumente bei call() einzeln als Liste übergeben werden, während sie bei apply() in einem Objekt, typischerweise einem Array, kombiniert sind — zum Beispiel func.call(this, "eat", "bananas") vs. func.apply(this, ["eat", "bananas"]).
Normalerweise, wenn eine Funktion aufgerufen wird, ist der Wert von this innerhalb der Funktion das Objekt, auf dem die Funktion aufgerufen wurde. Mit apply() können Sie einen beliebigen Wert als this beim Aufrufen einer bestehenden Funktion festlegen, ohne zuerst die Funktion als Eigenschaft an das Objekt anhängen zu müssen. Dies ermöglicht es Ihnen, Methoden eines Objekts als generische Utility-Funktionen zu verwenden.
Sie können auch jede Art von Objekt, das array-ähnlich ist, als zweiten Parameter verwenden. In der Praxis bedeutet das, dass es eine length Eigenschaft und ganze Zahl-Eigenschaften ("Index") im Bereich (0..length - 1) haben muss. Zum Beispiel könnten Sie ein NodeList oder ein benutzerdefiniertes Objekt wie { 'length': 2, '0': 'eat', '1': 'bananas' } verwenden. Sie können auch arguments verwenden, zum Beispiel:
Mit den Rest-Parametern und dem Parameter Spread-Syntax kann dies umgeschrieben werden als:
Im Allgemeinen ist fn.apply(null, args) äquivalent zu fn(...args) mit der Parameter-Spread-Syntax, außer dass args im ersten Fall mit apply() ein array-ähnliches Objekt und im zweiten Fall mit Spread-Syntax ein iterierbares Objekt sein muss.
Warnung: Verwenden Sie apply() nicht, um Konstruktoren zu verketten (zum Beispiel, um Vererbung zu implementieren). Dies ruft die Konstruktorfunktion als normale Funktion auf, was bedeutet, dass new.target undefined ist, und Klassen einen Fehler werfen, da sie nicht ohne new aufgerufen werden können. Verwenden Sie stattdessen Reflect.construct() oder extends.
Sie können Array.prototype.push() verwenden, um ein Element an ein Array anzuhängen. Da push() eine variable Anzahl von Argumenten akzeptiert, können Sie auch mehrere Elemente auf einmal anhängen. Aber wenn Sie ein Array an push() übergeben, wird dieses Array tatsächlich als einzelnes Element hinzugefügt, anstatt die Elemente einzeln hinzuzufügen, was zu einem Array innerhalb eines Arrays führt. Andererseits hat Array.prototype.concat() in diesem Fall das gewünschte Verhalten, aber es fügt nicht zum vorhandenen Array hinzu – es erstellt und gibt ein neues Array zurück.
In diesem Fall können Sie apply verwenden, um ein Array implizit als eine Serie von Argumenten zu "spreaden".
Der gleiche Effekt kann mit der Spread-Syntax erreicht werden.
Eine clevere Verwendung von apply() ermöglicht es Ihnen, eingebaute Funktionen für einige Aufgaben zu nutzen, die sonst wahrscheinlich ein manuelles Schleifen über eine Sammlung erfordern würden (oder die Spread-Syntax verwenden).
Zum Beispiel können wir Math.max() und Math.min() verwenden, um den maximalen und minimalen Wert in einem Array zu ermitteln.
Aber Vorsicht: Wenn Sie apply() (oder die Spread-Syntax) mit einer beliebig langen Argumentenliste verwenden, laufen Sie Gefahr, das Argumentlängenlimit der JavaScript-Engine zu überschreiten.
Die Konsequenzen eines Funktionsaufrufs mit zu vielen Argumenten (das heißt, mehr als zehntausend Argumenten) sind nicht spezifiziert und variieren je nach Engine. (Die JavaScriptCore-Engine hat ein festgelegtes Argumentlimit von 65536.) Die meisten Engines werfen eine Ausnahme; aber es gibt keine normative Spezifikation, die andere Verhaltensweisen verhindert, wie zum Beispiel das willkürliche Begrenzen der tatsächlich an die angewendete Funktion übergebenen Argumente. Um diesen letztgenannten Fall zu veranschaulichen: Wenn eine solche Engine ein Limit von vier Argumenten hätte (tatsächliche Limits sind natürlich erheblich höher), wäre es, als ob die Argumente 5, 6, 2, 3 in den obigen Beispielen an apply übergeben worden wären, anstatt des vollständigen Arrays.
Wenn Ihr Werte-Array auf zehntausende ansteigen könnte, verwenden Sie eine Hybridstrategie: Wenden Sie Ihre Funktion Stück für Stück auf das Array an:
| ECMAScript® 2027 Language Specification # sec-function.prototype.apply |
JavaScript aktivieren, um diese Browser-Kompatibilitätstabelle anzuzeigen.
Der Bauplan für ein besseres Internet.
Besuche die gemeinnützige Muttergesellschaft der Mozilla Corporation, die Mozilla Foundation.
Teile dieses Inhalts sind ©1998–2026 von einzelnen mozilla.org-Mitwirkenden. Inhalte sind verfügbar unter einer Creative-Commons-Lizenz.