CKTIS / JavaScript
Map.prototype.values: waarde-iterator
De methode values geeft een levende iterator over Map-waarden terug in invoegvolgorde van hun sleutels.
Versie: ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntax
map.values()map.values() maakt een nieuwe Map-iterator. Elke geslaagde next() geeft de waarde van het volgende item. Objecten blijven dezelfde referenties en gelijke waarden onder verschillende sleutels verschijnen apart; er is geen deduplicatie.
De iterator is lui, geen momentopname. Hij slaat vóór bezoek verwijderde items over, een eerdere bijwerking levert de nieuwe waarde en een toevoeging vóór het einde kan verschijnen. Bijwerken van een bezochte sleutel herhaalt hem niet. Na done: true hervatten toevoegingen hem niet.
De methode heeft geen betekenisvolle argumenten en vereist interne Map-gegevens; object, Set of onbehandelde Proxy werpt TypeError. Standaard sinds ECMAScript 2015. Gebruik entries() om de koppeling met sleutels te behouden.
Voorbeelden
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); }Resultaat
true 20 4 true true 1,1 true