CKTIS / JavaScript
Map.prototype.values: iterator wartości
Metoda values zwraca żywy iterator wartości Map w kolejności wstawiania odpowiadających im kluczy.
Wersja: ECMAScript 2015 onward; example target: Node.js 24.22.2
Składnia
map.values()map.values() tworzy nowy iterator Map. Każde udane next() zwraca wartość następnego wpisu w kolejności kluczy. Wartości-obiekty pozostają tymi samymi referencjami, a jednakowe wartości z różnych kluczy są zwracane osobno; iterator nie deduplikuje.
Iterator jest leniwy, nie migawkowy. Wpis usunięty przed odwiedzeniem jest pomijany, zmiana jeszcze nieodwiedzonego wpisu daje nową wartość, a wpis dodany przed końcem może zostać odwiedzony. Aktualizacja już odwiedzonego klucza nie powtarza go. Po done: true późniejsze dodatki nie wznawiają iteratora.
Metoda nie przyjmuje znaczących argumentów i wymaga odbiorcy z wewnętrznymi danymi Map; obiekt, Set lub nieobsłużony Proxy powoduje TypeError. Jest standardowa od ECMAScript 2015. Gdy potrzebne jest powiązanie wartości z kluczami, użyj entries() zamiast równoległego zgadywania pozycji.
Przykłady
const shared = {};
const map = new Map([["a", shared], ["b", 2], ["c", 2]]);
const values = map.values();
console.log(values.next().value === shared);
map.set("b", 20);
map.delete("c");
map.set("d", 4);
console.log(values.next().value);
console.log(values.next().value);
console.log(values.next().done);
map.set("e", 5);
console.log(values.next().done);
console.log([...new Map([["x", 1], ["y", 1]]).values()].join(","));
try { Map.prototype.values.call({}); } catch (error) { console.log(error instanceof TypeError); }Wynik
true 20 4 true true 1,1 true