Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

NodeList.forEach — iterare sui nodi

NodeList.forEach chiama una funzione per ciascun nodo successivo di una raccolta DOM, passandole il nodo, l’indice e la raccolta.

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

Sintassi

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

NodeList.forEach, disponibile come NodeList.prototype.forEach, chiama callback(node, index, nodeList) nell’ordine degli indici, a partire da zero. Restituisce undefined; i valori restituiti dalla funzione di callback vengono ignorati. Il metodo passa l’argomento facoltativo thisArg come valore di this quando chiama la funzione di callback, ma al suo interno this non coincide necessariamente con quel valore. Una funzione normale in modalità non strict sostituisce null o undefined con il proprio valore globale di this e incapsula gli altri valori primitivi in oggetti. Una funzione freccia usa il this dell’ambito che la contiene.

Una NodeList non è un array. querySelectorAll() restituisce una lista statica, mentre childNodes è una lista viva che include anche i nodi di testo. Evita di modificare una raccolta viva durante l’iterazione.

È una Web API, non una funzionalità di una specifica edizione di ECMAScript. Node 24 non dimostra il supporto del DOM. Nell’ambiente di destinazione, controlla typeof nodes.forEach === 'function'.

Esempi

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

Risultato

0:A:true
1:B:true

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti