KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Map.prototype.forEach: callback voor elk item

De methode forEach roept voor elk Map-item in invoegvolgorde een callback aan met waarde, sleutel en de Map zelf.

Versie: ECMAScript 2015 onward; example target: Node.js 24.22.2

Syntax

map.forEach(callbackFn[, thisArg])

map.forEach(callbackFn, thisArg?) roept callbackFn(value, key, map) aan voor elk niet-verwijderd item en geeft undefined terug. Argumenten beginnen met de waarde, anders dan bij entries(). Optioneel thisArg wordt volgens gewone regels this; een pijlfunctie negeert het door lexicale this.

De doorloop is levend, geen momentopname. Vóór bezoek verwijderde items worden overgeslagen; verwijderd en opnieuw toegevoegd kunnen op hun nieuwe plek worden bezocht, net als vóór voltooiing toegevoegde items. Een nog niet bezochte sleutel geeft na wijziging de nieuwe waarde.

Niet-aanroepbare callback of verkeerde ontvanger werpt TypeError; een uitzondering stopt de doorloop. Geen ingebouwde break en promises worden niet afgewacht. Standaard sinds ECMAScript 2015; gebruik for...of voor break, continue of sequentiële await.

Voorbeelden

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

Resultaat

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

Bronnen