Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri