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

Iterator : méthode forEach()

Baseline 2025
Newly available

Depuis March 2025, cette fonctionnalité fonctionne sur les appareils et les versions de navigateur les plus récents. Elle peut ne pas fonctionner sur les appareils ou navigateurs plus anciens.

La méthode forEach() des instances de Iterator est similaire à Array.prototype.forEach() : elle exécute une fonction fournie une fois pour chaque élément produit par l'itérateur.

Syntaxe

js
forEach(callbackFn)

Paramètres

callbackFn

Une fonction à exécuter pour chaque élément produit par l'itérateur. Sa valeur de retour est ignorée. La fonction est appelée avec les arguments suivants :

element

L'élément courant en cours de traitement.

index

L'indice de l'élément courant en cours de traitement.

Valeur de retour

Aucune (undefined).

Description

forEach() itère sur l'itérateur et invoque la fonction callbackFn une fois pour chaque élément. Contrairement à la plupart des autres méthodes d'aide aux itérateurs, elle ne fonctionne pas avec les itérateurs infinis, car elle n'est pas paresseuse.

Exemples

Utiliser la méthode forEach()

js
new Set([1, 2, 3]).values().forEach((v) => console.log(v));

// Affiche :
// 1
// 2
// 3

Ceci est équivalent à :

js
for (const v of new Set([1, 2, 3]).values()) {
  console.log(v);
}

Spécifications

Specification
ECMAScript® 2026 Language Specification
# sec-iterator.prototype.foreach

Compatibilité des navigateurs

Voir aussi