DOMTokenList: forEach()-Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Oktober 2017 browserübergreifend verfügbar.
Die forEach()-Methode der DOMTokenList-Schnittstelle ruft die als Parameter übergebene Callback-Funktion für jedes Wertepaar in der Liste in der Einfügereihenfolge auf.
Syntax
forEach(callback)
forEach(callback, thisArg)
Parameter
callback-
Die Funktion, die für jedes Element ausgeführt wird, nimmt schließlich drei Argumente entgegen:
currentValue-
Das aktuelle Element, das im Array verarbeitet wird.
currentIndex-
Der Index des aktuellen Elements, das im Array verarbeitet wird.
listObj-
Das Array, auf das
forEach()angewendet wird.
thisArgOptional-
Der Wert, der als
thisverwendet wird, wenncallbackausgeführt wird.
Rückgabewert
Keiner.
Beispiel
Im folgenden Beispiel erhalten wir die Liste der Klassen, die auf einem <pre>-Element als DOMTokenList festgelegt sind, unter Verwendung von Element.classList. Wir holen dann einen Iterator, der die Werte enthält, mithilfe von forEach() ab, wobei jeder Wert in das Node.textContent des <pre> während der Ausführung der inneren Funktion von forEach() geschrieben wird.
HTML
<pre class="a b c"></pre>
JavaScript
const pre = document.querySelector("pre");
const classes = pre.classList;
const iterator = classes.values();
classes.forEach(function (value, key, listObj) {
pre.textContent += `(${value} ${key})/${this}\n`;
}, "arg");
Ergebnis
Spezifikationen
| Spezifikation |
|---|
| DOM # interface-domtokenlist |