JavaScript forEach()Methode

Array 对象参考手册JavaScript Array-Objekt

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

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:
Parameter Beschreibung
currentValue Erforderlich. Das aktuelle Element
index Optional. Der Indexwert des aktuellen Elements.
arr Optional. Das Array-Objekt, zu dem das aktuelle Element gehört.
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)

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);
});

var arr = [1, 2, 3, 4, 5];

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;
});


Array 对象参考手册JavaScript Array-Objekt

Andere Erweiterungen