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 einmal für jeden Wert in der Liste auf, und zwar in der Reihenfolge, in der die Werte eingefügt wurden.
Syntax
forEach(callback)
forEach(callback, thisArg)
Parameter
callback-
Die Funktion, die für jedes Element ausgeführt wird. Sie erhält bis zu drei Argumente:
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 bei der Ausführung von
callbackalsthisverwendet wird.
Rückgabewert
Keiner.
Beispiel
Im folgenden Beispiel rufen wir die Liste der Klassen ab, die für ein <pre>-Element festgelegt wurden. Dazu verwenden wir Element.classList, das eine DOMTokenList zurückgibt. Anschließend durchlaufen wir die Werte mit forEach() und schreiben jeden Wert innerhalb der Callback-Funktion in den Node.textContent des <pre>-Elements.
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 |