CKTIS / JavaScript
Map.prototype.entries: iterator par klucz–wartość
Metoda entries zwraca żywy iterator par [key, value] z Map w kolejności wstawiania i jest domyślną metodą iteracji Map.
Wersja: ECMAScript 2015 onward; example target: Node.js 24.22.2
Składnia
map.entries()map.entries() tworzy nowy obiekt iteratora Map. Każde udane next() zwraca świeżą dwuelementową tablicę [key, value]; zmiana tej tablicy nie zmienia wpisu Map, choć zawarte obiekty nadal są tymi samymi referencjami. map[Symbol.iterator] jest tą samą funkcją co map.entries, więc for...of i spread domyślnie otrzymują pary.
Iterator jest leniwy i nie wykonuje migawki. Zachowuje kolejność wstawiania, pomija wpisy usunięte przed odwiedzeniem i może zobaczyć wpisy dodane zanim osiągnie koniec; aktualizacja wartości niewidzonego jeszcze klucza daje nową wartość. Gdy next() raz zwróci done: true, późniejsze dodanie wpisów nie wznawia tego iteratora.
Metoda nie przyjmuje znaczących argumentów i wymaga odbiorcy z wewnętrznymi danymi Map; pożyczenie jej dla zwykłego obiektu, Set albo nieobsłużonego Proxy powoduje TypeError. Jest standardowa od ECMAScript 2015. Do samych kluczy lub wartości użyj odpowiednio keys() albo values(), aby nie tworzyć tablic par.
Przykłady
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);Wynik
["a",1] 1 ["c",3] false true true true