JavaScript forEach()Méthode
Exemple
Lister chaque élément du tableau :
<button onclick="numbers.forEach(myFunction)">Cliquez ici</button>
<p id="demo"></p>
<script>
demoP = document.getElementById("demo");
var numbers = [4, 9, 16, 25];
function myFunction(item, index) {
demoP.innerHTML = demoP.innerHTML + "index[" + index + "]: " + item + "<br>";
}
</script>
Résultat de sortie :
index[0]: 4
index[1]: 9
index[2]: 16
index[3]: 25
index[1]: 9
index[2]: 16
index[3]: 25
Essayez-le vous-même »
Définition et utilisation
La méthode forEach() est utilisée pour appeler chaque élément d'un tableau et passer l'élément à une fonction de rappel.
Remarque :forEach() n'exécute pas la fonction de rappel pour les tableaux vides.
Prise en charge des navigateurs
Les chiffres du tableau indiquent le premier numéro de version du navigateur qui prend en charge la méthode.
| Méthode | |||||
|---|---|---|---|---|---|
| forEach() | Oui | 9.0 | 1.5 | Oui | Oui |
Syntaxe
array.forEach(callbackFn(currentValue, index, arr), thisValue)
Parameters
| Paramètre | Description | ||||||||
|---|---|---|---|---|---|---|---|---|---|
| callbackFn(currentValue, index, arr) | Obligatoire. La fonction à appeler pour chaque élément du tableau. Paramètres de fonction :
|
||||||||
| thisValue | Facultatif. La valeur transmise à la fonction est généralement utilisée comme valeur "this". Si ce paramètre est vide, "undefined" sera transmis à la valeur "this". |
Autres formats de syntaxe :
// Fonction fléchée
forEach((element) => { /* … */ })
forEach((element, index) => { /* … */ })
forEach((element, index, array) => { /* … */ })
// Fonction de rappel
forEach(callbackFn)
forEach(callbackFn, thisArg)
// Fonction de rappel en ligne
forEach(function(element) { /* … */ })
forEach(function(element, index) { /* … */ })
forEach(function(element, index, array){ /* … */ })
forEach(function(element, index, array) { /* … */ }, thisArg)
forEach((element) => { /* … */ })
forEach((element, index) => { /* … */ })
forEach((element, index, array) => { /* … */ })
// Fonction de rappel
forEach(callbackFn)
forEach(callbackFn, thisArg)
// Fonction de rappel en ligne
forEach(function(element) { /* … */ })
forEach(function(element, index) { /* … */ })
forEach(function(element, index, array){ /* … */ })
forEach(function(element, index, array) { /* … */ }, thisArg)
Détails techniques
| Valeur de retour : | undefined |
|---|---|
| Version JavaScript : | ECMAScript 3 |
Plus d’exemples
Exemple
Calculez la somme totale de tous les éléments du tableau :
<button onclick="numbers.forEach(myFunction)">Cliquez ici</button>
<p>Somme des éléments du tableau :<span id="demo"></span></p>
<script>
var sum = 0;
var numbers = [65, 44, 12, 4];
function myFunction(item) {
sum += item;
demo.innerHTML = sum;
}
</script>
Essayez-le vous-même »
Exemple
Multipliez toutes les valeurs du tableau par un nombre spécifique :
<p>Multiplier par :<input type="number" id="multiplyWith" value="10"></p>
<button onclick="numbers.forEach(myFunction)">Cliquez-moi</button>
<p>Valeur calculée :<span id="demo"></span></p>
<script>
var numbers = [65, 44, 12, 4];
function myFunction(item,index,arr) {
arr[index] = item * document.getElementById("multiplyWith").value;
demo.innerHTML = numbers;
}
</script>
Essayez-le vous-même »
Continue et Break dans forEach()
forEach() lui-même ne prend pas en charge les instructions continue et break. Nous pouvonssomeeteveryl'implémenter.
Utilisez l'instructionreturnpour implémentercontinuel'effet du mot-clé :
Implémentation de continue
Exemple
var arr = [1, 2, 3, 4, 5];
arr.forEach(function (item) {
if (item === 3) {
return;
}
console.log(item);
});
arr.forEach(function (item) {
if (item === 3) {
return;
}
console.log(item);
});

var arr = [1, 2, 3, 4, 5];
arr.some(function (item) {
if (item === 2) {
return; // Impossible de retourner false
}
console.log(item);
});
arr.some(function (item) {
if (item === 2) {
return; // Impossible de retourner false
}
console.log(item);
});

Implémentation de break
Exemple
var arr = [1, 2, 3, 4, 5];
arr.every(function (item) {
console.log(item);
return item !== 3;
});
arr.every(function (item) {
console.log(item);
return item !== 3;
});

Autres extensions
Objet Array JavaScript