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 Methode forEach() der Schnittstelle DOMTokenList ruft den übergebenen Callback 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 kann drei Argumente entgegennehmen:
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 beim Ausführen von
callbackalsthisverwendet wird.
Rückgabewert
Keiner.
Beispiel
Im folgenden Beispiel rufen wir die Liste der Klassen eines <pre>-Elements mithilfe von Element.classList als DOMTokenList ab. Anschließend durchlaufen wir die Werte mit forEach() und schreiben jeden Wert innerhalb der Callback-Funktion in die Eigenschaft 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 |