CKTIS / JavaScript
Set.prototype.values() — iterator vrijednosti skupa
Metoda values() vraća novi iterator vrijednosti objekta Set redoslijedom umetanja. Ne stvara polje ni kopiju skupa; svako čitanje pomiče iterator, a promjene skupa mogu utjecati na preostali prolazak.
Verzija: 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() poziva se bez argumenata kao set.values(). Vraća novi iterator vrijednosti redoslijedom umetanja, a ne polje. Sam poziv ne mijenja skup. Ponovno dodavanje postojeće vrijednosti ne stvara duplikat niti mijenja njezin položaj.
Metoda iteratora next() vraća objekt sa svojstvima value i done. Nakon što se iterator potroši, njihove su vrijednosti undefined i true; daljnji pozivi ne pokreću prolazak ispočetka. Za novi prolazak potreban je novi poziv set.values(). Iterator podržava for...of i [...iterator], koji troši preostale elemente.
Iterator nije snimka: preskače vrijednosti izbrisane prije nego što dođu na red, a može posjetiti vrijednosti dodane prije završetka prolaska. Brisanjem vrijednosti i njezinim ponovnim dodavanjem ona se premješta na kraj; zato može biti posjećena ponovno ako je njezina ranija pojava već pročitana. Izbjegavajte nekontrolirano dodavanje tijekom iteracije.
Prema zadanim postavkama, Set.prototype.keys i Set.prototype[Symbol.iterator] upućuju na istu funkciju kao Set.prototype.values. Nasuprot tome, entries() vraća parove [value, value]. values() zahtijeva primatelja s internim podacima Set; poziv na običnom objektu ili polju uzrokuje TypeError.
Primjeri
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"]Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.