JavaScript forEach()Methode
Beispiel
Listen Sie jedes Element des Arrays auf:
<button onclick="numbers.forEach(myFunction)">Klick mich</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>
Ausgabeergebnis:
index[0]: 4
index[1]: 9
index[2]: 16
index[3]: 25
index[1]: 9
index[2]: 16
index[3]: 25
Selbst ausprobieren »
Definition und Verwendung
Die forEach()-Methode wird verwendet, um jedes Element eines Arrays aufzurufen und das Element an eine Callback-Funktion zu übergeben.
Hinweis:forEach() führt die Callback-Funktion für leere Arrays nicht aus.
Browser-Unterstützung
Die Zahlen in der Tabelle geben die erste Browser-Versionsnummer an, die die Methode unterstützt.
| Methode | |||||
|---|---|---|---|---|---|
| forEach() | Ja | 9.0 | 1.5 | Ja | Ja |
Syntax
array.forEach(callbackFn(currentValue, index, arr), thisValue)
Parameters
| Parameter | Beschreibung | ||||||||
|---|---|---|---|---|---|---|---|---|---|
| callbackFn(currentValue, index, arr) | Erforderlich. Die Funktion, die für jedes Element im Array aufgerufen wird. Funktionsparameter:
|
||||||||
| thisValue | Optional. Der an die Funktion übergebene Wert wird im Allgemeinen als "this"-Wert verwendet. Wenn dieser Parameter leer ist, wird "undefined" an den "this"-Wert übergeben. |
Andere Syntaxformate:
// Pfeilfunktion
forEach((element) => { /* … */ })
forEach((element, index) => { /* … */ })
forEach((element, index, array) => { /* … */ })
// Callback-Funktion
forEach(callbackFn)
forEach(callbackFn, thisArg)
// Inline-Callback-Funktion
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) => { /* … */ })
// Callback-Funktion
forEach(callbackFn)
forEach(callbackFn, thisArg)
// Inline-Callback-Funktion
forEach(function(element) { /* … */ })
forEach(function(element, index) { /* … */ })
forEach(function(element, index, array){ /* … */ })
forEach(function(element, index, array) { /* … */ }, thisArg)
Technische Details
| Rückgabewert: | undefined |
|---|---|
| JavaScript-Version: | ECMAScript 3 |
Weitere Beispiele
Beispiel
Berechne die Gesamtsumme aller Elemente im Array:
<button onclick="numbers.forEach(myFunction)">Klick mich</button>
<p>Summe der Array-Elemente:<span id="demo"></span></p>
<script>
var sum = 0;
var numbers = [65, 44, 12, 4];
function myFunction(item) {
sum += item;
demo.innerHTML = sum;
}
</script>
Selbst ausprobieren »
Beispiel
Multipliziere alle Werte im Array mit einer bestimmten Zahl:
<p>Multiplizieren mit:<input type="number" id="multiplyWith" value="10"></p>
<button onclick="numbers.forEach(myFunction)">Klick mich</button>
<p>Berechneter Wert:<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>
Selbst ausprobieren »
Continue und Break in forEach()
forEach() selbst unterstützt die continue- und break-Anweisungen nicht. Wir könnensomeundevery verwendenes implementieren.
Verwenden Sie diereturn-Anweisung, umcontinueden Effekt des Schlüsselworts umzusetzen:
Implementierung von continue
Beispiel
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; // Kann nicht return false sein
}
console.log(item);
});
arr.some(function (item) {
if (item === 2) {
return; // Kann nicht return false sein
}
console.log(item);
});

Implementierung von break
Beispiel
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;
});

Andere Erweiterungen
JavaScript Array-Objekt