Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

NodeList.forEach — parcourir les nœuds

NodeList.forEach appelle une fonction pour chaque nœud successif d’une collection DOM, en lui transmettant le nœud, l’index et la collection.

Version : 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, disponible sous la forme NodeList.prototype.forEach, appelle callback(node, index, nodeList) dans l’ordre des index, à partir de zéro. La méthode renvoie undefined ; les valeurs renvoyées par le callback sont ignorées. La méthode fournit l’argument facultatif thisArg comme valeur de this lors de l’appel du callback, mais this à l’intérieur du callback n’a pas forcément cette valeur exacte. Hors du mode strict, une fonction classique remplace null ou undefined par sa valeur globale de this et encapsule les autres valeurs primitives dans des objets. Une fonction fléchée utilise le this de la portée englobante.

Une NodeList n’est pas un tableau. querySelectorAll() renvoie une liste statique, tandis que childNodes est une liste dynamique qui inclut également les nœuds de texte. Évitez de modifier une collection dynamique pendant son parcours.

Il s’agit d’une API Web, et non d’une fonctionnalité d’une édition particulière d’ECMAScript. Node 24 ne prouve pas la prise en charge du DOM. Dans l’environnement cible, vérifiez typeof nodes.forEach === 'function'.

Exemples

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

Résultat

0:A:true
1:B:true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources