CKTIS / JavaScript
Set.prototype.values() — iterator vrednosti množice
Metoda values() vrne nov iterator vrednosti Set v vrstnem redu dodajanja. Ne ustvari polja ali kopije množice; vsako branje premakne iterator, spremembe množice pa lahko vplivajo na nadaljnji prehod.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
set.values()Set.prototype.values() pokličite brez argumentov v obliki set.values(). Vrne nov iterator vrednosti v vrstnem redu dodajanja, ne pa polja. Sam klic množice ne spremeni. Ponovno dodajanje že obstoječe vrednosti ne ustvari dvojnika in ne spremeni njenega položaja.
Metoda iteratorja next() vrne objekt z lastnostma value in done. Ko je iterator izčrpan, sta njuni vrednosti undefined in true; nadaljnji klici prehoda ne začnejo znova. Za nov prehod je potreben ponoven klic set.values(). Iterator podpira for...of in [...iterator], ki porabi preostale elemente.
Iterator ni posnetek: preskoči vrednosti, odstranjene, preden pridejo na vrsto, in lahko obišče vrednosti, dodane pred koncem prehoda. Če vrednost odstranite in znova dodate, se premakne na konec; zato jo je mogoče obiskati znova, če je bila njena prejšnja pojavitev že prebrana. Med iteracijo se izogibajte nenadzorovanemu dodajanju.
Privzeto se Set.prototype.keys in Set.prototype[Symbol.iterator] sklicujeta na isto funkcijo kot Set.prototype.values. Nasprotno pa entries() vrne pare [value, value]. values() zahteva sprejemnik z notranjimi podatki Set; klic na navadnem objektu ali polju sproži TypeError.
Primeri
const set = new Set(["a", "b", "a"]);
const iterator = set.values();
console.log(JSON.stringify(iterator.next()));
console.log(JSON.stringify([...iterator]));
console.log(JSON.stringify(iterator.next()));
console.log(JSON.stringify([...set.values()]));Rezultat
{"value":"a","done":false}
["b"]
{"done":true}
["a","b"]Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.