Iterator.prototype.forEach()

Baseline 2025
Newly available

Since March 2025, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Die forEach()-Methode von Iterator-Instanzen ähnelt Array.prototype.forEach(): Sie führt eine bereitgestellte Funktion einmal für jedes vom Iterator erzeugte Element aus.

Syntax

js
forEach(callbackFn)

Parameter

callbackFn

Eine Funktion, die für jedes vom Iterator erzeugte Element ausgeführt wird. Ihr Rückgabewert wird verworfen. Die Funktion wird mit den folgenden Argumenten aufgerufen:

element

Das aktuell verarbeitete Element.

index

Der Index des aktuell verarbeiteten Elements.

Rückgabewert

Beschreibung

forEach() durchläuft den Iterator und ruft die callbackFn-Funktion einmal für jedes Element auf. Im Gegensatz zu den meisten anderen Iterator-Hilfsmethoden funktioniert es nicht mit unendlichen Iteratoren, da es nicht faul ist.

Beispiele

Verwendung von forEach()

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

// Logs:
// 1
// 2
// 3

Dies ist gleichbedeutend mit:

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

Spezifikationen

Specification
Iterator Helpers
# sec-iteratorprototype.foreach

Browser-Kompatibilität

Siehe auch