Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła