Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła