Map.prototype.forEach()

Diese Übersetzung ist unvollständig. Bitte helfen Sie, diesen Artikel aus dem Englischen zu übersetzen.

Die forEach() Methode führt eine übergebene Funktion für jedes Schlüssel/Wert Paar in dem Map Objekt aus. Die Reihenfolge richtet sich nach der Reihenfolge, in der die Schlüssel und Werte zu dem Map Objekt hinzugefügt wurden.

Syntax

myMap.forEach(callback[, thisArg])

Parameters

callback
Funktion, die für jedes Schlüssel/Wert Paar aufgerufen wird.
thisArg
Optional. Wert, der bei der Ausführung der callback-Funktion als this genutzt wird.

Return value

undefined.

Description

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 den folgenden 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 in der Map wird nur einmal an den callback übergeben, außer er wurde im callback gelöscht und neu hinzugefügt, bevor forEach beendet wurde. Die callback Funktion wird nicht aufgerufen, wenn der Wert vorher aus der Map gelöscht wurde. Neue Werte, die im callback zu der Map hinzugefügt werden, bevor der Durchlauf beendet ist, werden auch berücksichtigt.

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

Specification Status Comment
ECMAScript 2015 (6th Edition, ECMA-262)
Die Definition von 'Map.prototype.forEach' in dieser Spezifikation.
Standard Initial definition.
ECMAScript Latest Draft (ECMA-262)
Die Definition von 'Map.prototype.forEach' in dieser Spezifikation.
Entwurf  

Browser Kompatibilität

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support 38 25.0 (25.0) 11 25 7.1
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support Nicht unterstützt 38 25.0 (25.0) Nicht unterstützt Nicht unterstützt 8

Siehe auch

Schlagwörter des Dokuments und Mitwirkende

 Mitwirkende an dieser Seite: Techworker
 Zuletzt aktualisiert von: Techworker,