Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

NodeList.forEach — iterowanie po węzłach

NodeList.forEach wywołuje funkcję dla kolejnych węzłów kolekcji DOM, przekazując węzeł, indeks i kolekcję.

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

Składnia

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

NodeList.forEach, dostępne jako NodeList.prototype.forEach, wywołuje callback(node, index, nodeList) w kolejności indeksów od zera. Zwraca undefined; wyniki funkcji są ignorowane. Metoda przekazuje opcjonalny thisArg jako wartość this przy wywołaniu funkcji zwrotnej, ale this wewnątrz tej funkcji nie musi mieć dokładnie tej wartości. Zwykła funkcja poza trybem ścisłym zastępuje null lub undefined globalną wartością this, a pozostałe wartości prymitywne opakowuje w obiekty. Funkcja strzałkowa korzysta z this z otaczającego zakresu.

NodeList nie jest tablicą. querySelectorAll() zwraca listę statyczną, a childNodes — żywą, zawierającą również węzły tekstowe. Unikaj zmiany żywej kolekcji podczas iterowania.

To Web API, nie funkcja określonej edycji ECMAScript. Node 24 nie dowodzi obsługi DOM. W docelowym środowisku sprawdź typeof nodes.forEach === 'function'.

Przykłady

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

Wynik

0:A:true
1:B:true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła