CKTIS / JavaScript
Map.prototype.values: iterator vrednosti
Metoda values vrne živ iterator vrednosti Map v vrstnem redu vstavljanja pripadajočih ključev.
Različica: ECMAScript 2015 onward; example target: Node.js 24.22.2
Sintaksa
map.values()map.values() ustvari nov iterator Map. Vsak uspešen next() vrne vrednost naslednjega vnosa. Objekti ostanejo isti sklici, enake vrednosti pod različnimi ključi pa se vrnejo ločeno; brez odstranjevanja dvojnikov.
Iterator je len, ni posnetek. Preskoči pred obiskom izbrisan vnos, predhodna posodobitev poda novo vrednost, dodatek pred koncem pa je lahko viden. Posodobitev obiskanega ključa ga ne ponovi. Po done: true ga dodatki ne nadaljujejo.
Metoda nima pomenljivih argumentov in zahteva notranje podatke Map; objekt, Set ali neobravnavan Proxy sproži TypeError. Standardna od ECMAScript 2015. Za povezavo s ključi uporabite entries().
Primeri
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); }Rezultat
true 20 4 true true 1,1 true