CKTIS / JavaScript
Map.prototype.forEach: callback за всеки запис
Методът forEach извиква callback за всеки запис на Map по реда на вмъкване и подава стойност, ключ и самия Map.
Версия: ECMAScript 2015 onward; example target: Node.js 24.22.2
Синтаксис
map.forEach(callbackFn[, thisArg])map.forEach(callbackFn, thisArg?) извиква callbackFn(value, key, map) за всеки неизтрит запис и връща undefined. Аргументите започват със стойността, за разлика от entries(). Незадължителният thisArg става this; arrow функция го игнорира заради лексикалния this.
Обхождането е живо, не е снимка. Запис, изтрит преди посещението, се пропуска; изтрит и добавен отново може да бъде посетен на новата позиция, както и запис, добавен преди края. Промяна на още непосетен ключ подава новата стойност.
Неизвикваем callback или грешен получател хвърля TypeError; изключение спира обхождането. Няма вграден break и Promise не се изчакват. Стандартен от ECMAScript 2015; за break, continue или последователен await използвайте for...of.
Примери
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);
}Резултат
#a:1,#c:3 true a:1,c:3 true