CKTIS / JavaScript
Map.prototype.values: iterátor hodnot
Metoda values vrátí živý iterátor hodnot Map v pořadí vložení odpovídajících klíčů.
Verze: ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntaxe
map.values()map.values() vytvoří nový iterátor Map. Každé úspěšné next() vrátí hodnotu další položky. Objekty zůstávají stejnými odkazy a stejné hodnoty pod různými klíči se vracejí odděleně; bez deduplikace.
Iterátor je líný, nikoli snímek. Přeskočí položku odstraněnou před návštěvou, dřívější aktualizace dá novou hodnotu a přidání před koncem může být vidět. Aktualizace navštíveného klíče jej neopakuje. Po done: true jej další přidání neobnoví.
Metoda nemá významné argumenty a vyžaduje interní data Map; objekt, Set či neošetřený Proxy vyvolá TypeError. Standardní od ECMAScript 2015. Pro zachování vazby na klíče použijte entries().
Příklady
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); }Výsledek
true 20 4 true true 1,1 true