Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Map.prototype.forEach: callback pre každú položku

Metóda forEach zavolá callback pre každú položku Map v poradí vloženia a odovzdá hodnotu, kľúč aj samotný Map.

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

Syntax

map.forEach(callbackFn[, thisArg])

map.forEach(callbackFn, thisArg?) volá callbackFn(value, key, map) pre každú neodstránenú položku a vráti undefined. Argumenty začínajú hodnotou, na rozdiel od entries(). Voliteľný thisArg sa stane this; arrow funkcia ho pre lexikálne this ignoruje.

Prechod je živý, nie snímka. Pred návštevou odstránená položka sa preskočí; odstránená a znovu pridaná môže byť navštívená na novej pozícii, rovnako ako položka pridaná pred koncom. Zmena ešte nenavštíveného kľúča odovzdá novú hodnotu.

Nevolateľný callback alebo chybný prijímač vyvolá TypeError; výnimka prechod zastaví. Nie je zabudovaný break a Promise sa nečakajú. Štandardná od ECMAScript 2015; pre break, continue či sekvenčný await použite for...of.

Príklady

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

Výsledok

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

Zdroje