Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes