Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Map.prototype.forEach: callback za vsak vnos

Metoda forEach pokliče callback za vsak vnos Map v vrstnem redu vstavljanja ter poda vrednost, ključ in sam Map.

Različica: ECMAScript 2015 onward; example target: Node.js 24.22.2

Sintaksa

map.forEach(callbackFn[, thisArg])

map.forEach(callbackFn, thisArg?) pokliče callbackFn(value, key, map) za vsak neizbrisan vnos in vrne undefined. Argumenti se začnejo z vrednostjo, drugače kot pri entries(). Izbirni thisArg postane this; puščična funkcija ga zaradi leksikalnega this prezre.

Prehod je živ, ni posnetek. Pred obiskom izbrisan vnos se preskoči; izbrisan in znova dodan je lahko obiskan na novem mestu, prav tako vnos, dodan pred koncem. Sprememba še neobiskanega ključa poda novo vrednost.

Neizvedljiv callback ali napačen prejemnik sproži TypeError; izjema ustavi prehod. Vgrajenega break ni in Promise se ne čakajo. Standardna od ECMAScript 2015; za break, continue ali zaporedni await uporabite for...of.

Primeri

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);
}

Rezultat

#a:1,#c:3
true
a:1,c:3
true

Viri