CKTIS / JavaScript
Map.prototype.entries: итератор на двойки ключ–стойност
Методът entries връща жив итератор на двойки [key, value] по реда на вмъкване и е стандартната итерация на Map.
Версия: ECMAScript 2015 onward; example target: Node.js 24.22.2
Синтаксис
map.entries()map.entries() създава нов обект итератор на Map. Всяко успешно next() връща нов двуелементен масив [key, value]; промяната му не изменя записа в Map, макар съдържаните обекти да остават същите препратки. map[Symbol.iterator] е същата функция като map.entries, затова for...of и spread получават двойки по подразбиране.
Итераторът е ленив, не е моментна снимка. Той пази реда на вмъкване, прескача записи, изтрити преди посещението, и може да види записи, добавени преди края; промяна на още непосетен ключ дава новата стойност. След като next() върне done: true, по-късни добавяния не възобновяват итератора.
Методът няма значими аргументи и изисква получател с вътрешни данни на Map; обикновен обект, Set или необработен Proxy хвърля TypeError. Стандартен е от ECMAScript 2015. Когато трябват само ключове или стойности, keys() или values() избягват масивите от двойки.
Примери
const map = new Map([["a", 1], ["b", 2]]);
const entries = map.entries();
const first = entries.next().value;
console.log(JSON.stringify(first));
first[1] = 99;
console.log(map.get("a"));
map.delete("b");
map.set("c", 3);
const second = entries.next();
console.log(JSON.stringify(second.value), second.done);
console.log(entries.next().done);
map.set("d", 4);
console.log(entries.next().done);
console.log(map[Symbol.iterator] === map.entries);Резултат
["a",1] 1 ["c",3] false true true true