CKTIS / JavaScript
Map.prototype.values: iterátor hodnôt
Metóda values vráti živý iterátor hodnôt Map v poradí vloženia zodpovedajúcich kľúčov.
Verzia: ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntax
map.values()map.values() vytvorí nový iterátor Map. Každé úspešné next() vráti hodnotu ďalšej položky. Objekty zostávajú rovnakými odkazmi a rovnaké hodnoty pod rôznymi kľúčmi sa vracajú oddelene; bez deduplikácie.
Iterátor je lenivý, nie snímka. Preskočí položku odstránenú pred návštevou, skoršia aktualizácia dá novú hodnotu a pridanie pred koncom môže byť vidieť. Aktualizácia navštíveného kľúča ho neopakuje. Po done: true ho ďalšie pridanie neobnoví.
Metóda nemá významné argumenty a vyžaduje interné údaje Map; objekt, Set či neošetrený Proxy vyvolá TypeError. Štandardná od ECMAScript 2015. Na zachovanie väzby na kľúče použite entries().
Prí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ýsledok
true 20 4 true true 1,1 true