Map.prototype.forEach()

Probieren Sie es aus

function logMapElements(value, key, map) {
  console.log(`m[${key}] = ${value}`);
}

new Map([
  ["foo", 3],
  ["bar", {}],
  ["baz", undefined],
]).forEach(logMapElements);

// Expected output: "m[foo] = 3"
// Expected output: "m[bar] = [object Object]"
// Expected output: "m[baz] = undefined"

Syntax

forEach(callbackFn)
forEach(callbackFn, thisArg)

Parameter

callbackFn

Eine Funktion, die fr jeden Eintrag in der Map ausgefhrt wird. Die Funktion wird mit den folgenden Argumenten aufgerufen:

value

Wert jeder Iteration.

key

Schlssel jeder Iteration.

map

Die Map, die durchlaufen wird.

thisArg Optional

Ein Wert, der als this beim Ausfhren von callbackFn verwendet wird.

Rckgabewert

Keiner (undefined).

Beschreibung

Die forEach-Methode fhrt den bereitgestellten callback einmal fr jeden in der Map tatschlich vorhandenen Schlssel aus. Sie wird nicht fr Schlssel aufgerufen, die gelscht wurden. Sie wird jedoch fr Werte ausgefhrt, die vorhanden sind, aber den Wert undefined haben.

callback wird mit drei Argumenten aufgerufen:

• dem value des Eintrags
• dem key des Eintrags
• dem durchlaufenen Map-Objekt

Wenn ein thisArg-Parameter an forEach bergeben wird, wird er an callback weitergegeben, um als this-Wert verwendet zu werden. Andernfalls wird der Wert undefined zur Nutzung als this-Wert weitergegeben. Der schlielich von callback observable this-Wert wird gem den blichen Regeln zur Bestimmung des this, das von einer Funktion gesehen wird bestimmt.

Jeder Wert wird einmal besucht, auer in dem Fall, dass er gelscht und wieder hinzugefgt wurde, bevor forEach abgeschlossen ist. callback wird nicht fr Werte aufgerufen, die vor dem Besuch gelscht wurden. Neue Werte, die hinzugefgt werden, bevor forEach abgeschlossen ist, werden besucht.

Beispiele

Den Inhalt eines Map-Objekts ausgeben

Der folgende Code protokolliert eine Zeile fr jedes Element in einem Map-Objekt:

function logMapElements(value, key, map) {
  console.log(`map.get('${key}') = ${value}`);
}
new Map([
  ["foo", 3],
  ["bar", {}],
  ["baz", undefined],
]).forEach(logMapElements);
// Logs:
// "map.get('foo') = 3"
// "map.get('bar') = [object Object]"
// "map.get('baz') = undefined"

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• Array.prototype.forEach()
• Set.prototype.forEach()