CKTIS / JavaScript
Map.prototype.values: Werteiterator
Die Methode values liefert einen lebenden Iterator über Map-Werte in Einfügereihenfolge der zugehörigen Schlüssel.
Version: ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntax
map.values()map.values() erzeugt einen neuen Map-Iterator. Jedes erfolgreiche next() liefert den Wert des nächsten Eintrags. Objektwerte bleiben dieselben Referenzen; gleiche Werte verschiedener Schlüssel erscheinen getrennt und werden nicht dedupliziert.
Der Iterator ist faul, keine Momentaufnahme. Vor dem Besuch gelöschte Einträge werden übersprungen, eine Änderung vor dem Besuch liefert den neuen Wert und vor dem Ende hinzugefügte Einträge können erscheinen. Ein bereits besuchter Schlüssel wird durch Aktualisierung nicht wiederholt. Nach done: true gibt es keine Fortsetzung.
Die Methode hat keine bedeutungsvollen Argumente und verlangt interne Map-Daten; Objekt, Set oder unbehandelter Proxy löst TypeError aus. Seit ECMAScript 2015 Standard. Für die Zuordnung zu Schlüsseln dient entries().
Beispiele
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); }Ergebnis
true 20 4 true true 1,1 true