CKTIS / JavaScript
Map.prototype.forEach: callback dla każdego wpisu
Metoda forEach wywołuje callback dla każdego wpisu Map w kolejności wstawiania, przekazując wartość, klucz i samą Map.
Wersja: ECMAScript 2015 onward; example target: Node.js 24.22.2
Składnia
map.forEach(callbackFn[, thisArg])map.forEach(callbackFn, thisArg?) wywołuje callbackFn(value, key, map) dla każdego nieusuniętego wpisu i zwraca undefined. Kolejność argumentów zaczyna się od wartości, inaczej niż para z entries(). Opcjonalny thisArg jest wartością this callbacku według zwykłych reguł; funkcja strzałkowa ignoruje go przez leksykalne this.
Przejście jest żywe, nie jest migawką. Wpis usunięty przed odwiedzeniem jest pomijany; usunięty i ponownie dodany może zostać odwiedzony na nowej pozycji, a wpis dodany przed końcem także może zostać odwiedzony. Zmiana wartości jeszcze nieodwiedzonego klucza przekazuje nową wartość.
Niewywoływalny callback lub odbiorca bez danych Map powoduje TypeError; wyjątek z callbacku przerywa przejście. Nie ma wbudowanego break, a zwracane Promise nie są oczekiwane. Metoda jest standardowa od ECMAScript 2015; dla break, continue lub sekwencyjnego await użyj for...of.
Przykłady
const map = new Map([["a", 1], ["b", 2]]);
const seen = [];
const result = map.forEach(function (value, key, original) {
seen.push(this.prefix + key + ":" + value);
if (key === "a") {
original.delete("b");
original.set("c", 3);
}
}, { prefix: "#" });
console.log(seen.join(","));
console.log(result === undefined);
console.log([...map].map(([key, value]) => key + ":" + value).join(","));
try {
map.forEach(null);
} catch (error) {
console.log(error instanceof TypeError);
}Wynik
#a:1,#c:3 true a:1,c:3 true