Die forEach()
Methode führt eine übergebene Funktion für jedes Schlüssel/Wert Paar in dem Map
Objekt in der Einfügereihenfolge aus.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
Syntax
myMap.forEach(callback[, thisArg])
Parameter
callback
- Funktion, die für jedes Schlüssel/Werte-Paar aufgerufen wird.
thisArg
- Wert, der bei der Ausführung der
callback
-Funktion alsthis
genutzt wird.
Rückgabewert
Beschreibung
Die forEach
Methode ruft die übergebene Funktion für jedes Schlüssel/Wert Paar in dem Map
Objekt aus. Die callback
Funktion wird nicht aufgerufen, wenn der Schlüssel gelöscht wurde. Sie wird aber aufgerufen, wenn der aktuelle Wert undefined
ist.
Die callback
Funktion wird mit drei Parametern aufgerufen:
- der Wert des Elements
- der Schlüssel des Elements
- das
Map
Objekt, das durchlaufen wird
Wenn der thisArg
-Parameter an forEach
übergeben wird, wird er auch an die callback-Funktion
als deren this
Wert weitergegeben. Andernfalls wird dafür undefined
genutzt. Der this
-Wert, der in der callback-Funktion
wahrgenommen wird, ist festgelegt durch die generellen Regeln für die Nutzung von this
in einer Funktion.
Jeder Wert wird einmal besucht, mit Außnahme von Fällen, in denen ein Wert glöscht und neu hinzugefügt wird, bevor forEach
fertig ist. Die callback
Funktion wird nicht für Wert aufgerufen, die vorher gelöscht wurden. Neue Werte, die vor der Beendigung von forEach
hinzugefügt werden, werden berücksichtigt.
Die forEach
Methode ruft callback
für jedes Element in dem Map
Objekt aus. forEach
gibt keinen Wert zurück.
Beispiele
Ausgabe der Inhalte eines Map
Objekts
Der folgende Code gibt für jedes Element in der Map eine Nachricht in der Konsole aus.
function logMapElements(value, key, map) { console.log(`m[${key}] = ${value}`); } new Map([['foo', 3], ['bar', {}], ['baz', undefined]]).forEach(logMapElements); // logs: // "m[foo] = 3" // "m[bar] = [object Object]" // "m[baz] = undefined"
Spezifikationen
Spezifikation | Status | Kommentar |
---|---|---|
ECMAScript 2015 (6th Edition, ECMA-262) Die Definition von 'Map.prototype.forEach' in dieser Spezifikation. |
Standard | Initiale Definition. |
ECMAScript Latest Draft (ECMA-262) Die Definition von 'Map.prototype.forEach' in dieser Spezifikation. |
Entwurf |
Browserkompatibilität
Desktop | Mobile | Server | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
forEach | Chrome Vollständige Unterstützung 38 | Edge Vollständige Unterstützung 12 | Firefox Vollständige Unterstützung 25 | IE Vollständige Unterstützung 11 | Opera Vollständige Unterstützung 25 | Safari Vollständige Unterstützung 8 | WebView Android Vollständige Unterstützung 38 | Chrome Android Vollständige Unterstützung 38 | Firefox Android Vollständige Unterstützung 25 | Opera Android Vollständige Unterstützung 25 | Safari iOS Vollständige Unterstützung 8 | Samsung Internet Android Vollständige Unterstützung 3.0 | nodejs Vollständige Unterstützung 0.12 |
Legende
- Vollständige Unterstützung
- Vollständige Unterstützung