Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

NodeList.forEach — iterace přes uzly

NodeList.forEach volá funkci pro jednotlivé uzly kolekce DOM a předává jí uzel, index a kolekci.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

nodeList.forEach(callback[, thisArg])
callback(node, index, nodeList)

NodeList.forEach, dostupné jako NodeList.prototype.forEach, volá callback(node, index, nodeList) v pořadí indexů od nuly. Vrací undefined; návratové hodnoty funkce callback se ignorují. Metoda při volání funkce callback předává volitelný argument thisArg jako hodnotu this, ale uvnitř funkce nemusí mít this přesně tuto hodnotu. Běžná funkce mimo striktní režim nahradí null nebo undefined svou globální hodnotou this a ostatní primitivní hodnoty zabalí do objektů. Šipková funkce používá this z okolního rozsahu platnosti.

NodeList není pole. querySelectorAll() vrací statický seznam, zatímco childNodes je živý seznam, který obsahuje také textové uzly. Během iterace živou kolekci neměňte.

Jde o Web API, nikoli o funkci určité edice ECMAScriptu. Node 24 nedokazuje podporu DOM. V cílovém prostředí ověřte typeof nodes.forEach === 'function'.

Příklady

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'));

Výsledek

0:A:true
1:B:true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje