Map.prototype.forEach()

Die forEach() Methode führt eine übergebene Funktion für jedes Schlüssel/Wert Paar in dem Map Objekt in der Einfügereihenfolge aus.

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 als this genutzt wird.

Rückgabewert

undefined.

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

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid WebviewChrome für AndroidFirefox für AndroidOpera für AndroidSafari auf iOSSamsung InternetNode.js
forEachChrome Vollständige Unterstützung 38Edge Vollständige Unterstützung 12Firefox Vollständige Unterstützung 25IE Vollständige Unterstützung 11Opera Vollständige Unterstützung 25Safari Vollständige Unterstützung 8WebView Android Vollständige Unterstützung 38Chrome Android Vollständige Unterstützung 38Firefox Android Vollständige Unterstützung 25Opera Android Vollständige Unterstützung 25Safari iOS Vollständige Unterstützung 8Samsung Internet Android Vollständige Unterstützung 3.0nodejs Vollständige Unterstützung 0.12

Legende

Vollständige Unterstützung  
Vollständige Unterstützung

Siehe auch

Verwandte Themen
  1. Standard-Objekte
  2. Map
  3. Eigenschaften
    1. Map.prototype
    2. Map.prototype.size
    3. Map.prototype[@@toStringTag]
    4. get Map[@@species]
  4. Methoden
    1. Map.prototype.clear()
    2. Map.prototype.delete()
    3. Map.prototype.entries()
    4. Map.prototype.forEach()
    5. Map.prototype.get()
    6. Map.prototype.has()
    7. Map.prototype.keys()
    8. Map.prototype.set()
    9. Map.prototype.values()
    10. Map.prototype[@@iterator]()
  5. Vererbung:
  6. Function
  7. Eigenschaften
    1. Function.arguments
    2. Function.arity
    3. Function.caller
    4. Function.displayName
    5. Function.length
    6. Function.name
    7. Function.prototype
  8. Methoden
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.isGenerator()
    5. Function.prototype.toSource()
    6. Function.prototype.toString()
  9. Object
  10. Eigenschaften
    1. Object.prototype.__count__ [Übersetzen]
    2. Object.prototype.__noSuchMethod__ [Übersetzen]
    3. Object.prototype.__parent__ [Übersetzen]
    4. Object.prototype.__proto__
    5. Object.prototype.constructor
  11. Methoden
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__() [Übersetzen]
    3. Object.prototype.__lookupGetter__() [Übersetzen]
    4. Object.prototype.__lookupSetter__() [Übersetzen]
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf() [Übersetzen]
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString() [Übersetzen]
    9. Object.prototype.toSource()
    10. Object.prototype.toString()
    11. Object.prototype.unwatch() [Übersetzen]
    12. Object.prototype.valueOf()
    13. Object.prototype.watch() [Übersetzen]
    14. Object.setPrototypeOf() [Übersetzen]