Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła