CKTIS / JavaScript
NodeList.forEach — percorrer nós
NodeList.forEach chama uma função para cada nó sucessivo de uma coleção DOM, passando-lhe o nó, o índice e a coleção.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
nodeList.forEach(callback[, thisArg])
callback(node, index, nodeList)NodeList.forEach, disponível como NodeList.prototype.forEach, chama callback(node, index, nodeList) pela ordem dos índices, começando em zero. Devolve undefined; os valores devolvidos pela função de callback são ignorados. O método fornece o argumento opcional thisArg como valor de this ao chamar a função de callback, mas o this no interior da função não tem necessariamente esse valor exato. Uma função normal fora do modo estrito substitui null ou undefined pelo seu valor global de this e encapsula os restantes valores primitivos em objetos. Uma função de seta usa o this do âmbito em que está definida.
Uma NodeList não é um array. querySelectorAll() devolve uma lista estática, enquanto childNodes é uma lista viva que também inclui nós de texto. Evite modificar uma coleção viva durante a iteração.
É uma API Web, não uma funcionalidade de uma edição específica de ECMAScript. O Node 24 não comprova o suporte de DOM. No ambiente de destino, verifique typeof nodes.forEach === 'function'.
Exemplos
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'));Resultado
0:A:true 1:B:true
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.