CKTIS / JavaScript
NodeList.forEach — über Knoten iterieren
NodeList.forEach ruft für die aufeinanderfolgenden Knoten einer DOM-Sammlung eine Funktion auf und übergibt ihr den Knoten, den Index und die Sammlung.
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
nodeList.forEach(callback[, thisArg])
callback(node, index, nodeList)NodeList.forEach, verfügbar als NodeList.prototype.forEach, ruft callback(node, index, nodeList) in aufsteigender Indexreihenfolge ab null auf. Die Methode gibt undefined zurück; Rückgabewerte des Callbacks werden ignoriert. Die Methode übergibt das optionale thisArg beim Aufruf des Callbacks als this-Wert, doch this im Callback muss nicht genau diesem Wert entsprechen. Eine gewöhnliche Funktion außerhalb des strikten Modus ersetzt null oder undefined durch ihren globalen this-Wert und verpackt andere primitive Werte in Objekte. Eine Pfeilfunktion verwendet this aus ihrem umgebenden Gültigkeitsbereich.
Eine NodeList ist kein Array. querySelectorAll() gibt eine statische Liste zurück, während childNodes eine dynamische Liste ist, die auch Textknoten enthält. Vermeide es, eine dynamische Sammlung während der Iteration zu verändern.
Dies ist eine Web API und keine Funktion einer bestimmten ECMAScript-Ausgabe. Node 24 belegt keine DOM-Unterstützung. Prüfe in der Zielumgebung typeof nodes.forEach === 'function'.
Beispiele
const root = document.createElement('div');
for (const text of ['A', 'B']) {
const item = document.createElement('span');
item.textContent = text;
root.appendChild(item);
}
const nodes = root.querySelectorAll('span');
const lines = [];
nodes.forEach((node, index, list) => {
lines.push(`${index}:${node.textContent}:${list === nodes}`);
});
console.log(lines.join('\n'));Ergebnis
0:A:true 1:B:true
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.