Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

NodeList : méthode forEach()

Baseline
Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis octobre 2017.

La méthode forEach() de l'interface NodeList appelle le rappel donné en paramètre une fois pour chaque paire de valeurs dans la liste, dans l'ordre d'insertion.

Syntaxe

js
forEach(callback)
forEach(callback, thisArg)

Paramètres

callback

Une fonction à exécuter sur chaque élément de someNodeList. Elle accepte 3 paramètres :

currentValue

L'élément en cours de traitement dans someNodeList.

currentIndex Facultatif

L'index de l'élément currentValue en cours de traitement dans someNodeList.

listObj Facultatif

Le someNodeList auquel forEach() est appliqué.

thisArg Facultatif

Valeur à utiliser comme this lors de l'exécution du callback.

Valeur de retour

Aucune (undefined).

Exemples

js
const noeud = document.createElement("div");
const enfant1 = document.createElement("p");
const enfant2 = document.createTextNode("hey");
const enfant3 = document.createElement("span");

noeud.appendChild(enfant1);
noeud.appendChild(enfant2);
noeud.appendChild(enfant3);

const liste = noeud.childNodes;

liste.forEach(function (valeurActuelle, indexActuel, listObj) {
  console.log(`${valeurActuelle}, ${indexActuel}, ${this}`);
}, "myThisArg");

Le code ci-dessus produit le résultat suivant :

[object HTMLParagraphElement], 0, myThisArg
[object Text], 1, myThisArg
[object HTMLSpanElement], 2, myThisArg

Spécifications

Spécification
DOM
# interface-nodelist

Compatibilité des navigateurs

Voir aussi