Méthode : Array.forEach()

Parcourt un à un les éléments du tableau pour y exécuter une fonction

Syntaxe
tableau.forEach(Function ToDo)

Compatible tous navigateurs

Oui

Description
Parcourt un à un les éléments du tableau et exécute la fonction ToDo() sur chaque élément parcouru.

La fonction ToDo() attend 3 paramètres :
element : paramètre obligatoire qui contient l'élément en cours de traitement
index : paramètre facultatif qui contient le nombre d'itération parcourue
array : paramètre facultatif qui remonte le tableau d'origine

Même les éléments supprimés sont parcourus.
Il n'existe pas de moyen d'arrêter le parcours.

La boucle for est une alternative.

La méthode map() lance une fonction sur chaque élément du tableau et retourne un nouveau tableau.

Exemple 1 : Parcours d'un tableau

Code source

Résultat

Emulation de la console

Explication

Ici la fonction est définie de manière anonyme, directement dans l'appel à forEach(). Chaque élément est affiché dans la console en majuscule avec son indice.

Dans l'exemple suivant, on utilisera un pointeur vers la fonction.

Exemple 2 : Parcours d'un tableau avec une fonction prédéfinie

Code source

<table id="personnel">
<tr><th>Numeros</th><th>Prénoms</th><th>Ages</th></tr>
</table>
<script>
var tableau=[{"prenom":"Jean", "age": 44}, {"prenom":"Pierre", "age":30}, {"prenom":"Paul", "age":22}, {"prenom":"Marie", "age":34}];

function afficheElement(element, index, array) {
var ligne=document.createElement("tr");
ligne.innerHTML="<td>"+(index+1)+"/"+array.length+"</td>";
ligne.innerHTML+="<td>"+element.prenom+"</td>";
ligne.innerHTML+="<td>"+element.age+"</td>";
document.querySelector("table#personnel").appendChild(ligne);
}

tableau.forEach(afficheElement);
</script>

Résultat

Numeros	Prénoms	Ages

Emulation de la console

Explication

La fonction afficheElement() est définie avant l'appel à forEach() .

Page en rapport
Le tutorial tableaux JavaScript

Page mise à jour le 16/11/2018

Troisième édition Tout JavaScript chez Dunod

En savoir plus
Sortie le 4 janvier 2023

Version papier à 29€90
Format électronique à 22€99.

Commandez en ligne

Dunod Fnac Amazon

Méthode : Array.forEach()

Parcourt un à un les éléments du tableau pour y exécuter une fonction

Troisième édition Tout JavaScript chez Dunod

Chercher une fonction, un objet, ...