CKTIS / JavaScript
Set.prototype.values() — iterátor hodnôt množiny
Metóda values() vracia nový iterátor hodnôt Set v poradí ich vloženia. Nevytvára pole ani kópiu množiny; každé čítanie posúva iterátor a zmeny množiny môžu ovplyvniť zostávajúci priechod.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
set.values()Set.prototype.values() volajte bez argumentov ako set.values(). Vracia nový iterátor hodnôt v poradí ich vloženia, nie pole. Samotné volanie množinu nemení. Opätovné pridanie už existujúcej hodnoty nevytvorí duplikát ani nezmení jej pozíciu.
Metóda iterátora next() vracia objekt s vlastnosťami value a done. Po vyčerpaní iterátora majú tieto vlastnosti hodnoty undefined a true; ďalšie volania priechod znova nespustia. Nový priechod vyžaduje ďalšie volanie set.values(). Iterátor podporuje for...of a [...iterator], ktoré spotrebuje jeho zostávajúce prvky.
Iterátor nie je snímka: hodnoty odstránené pred návštevou preskočí a môže navštíviť hodnoty pridané pred dokončením priechodu. Odstránenie a opätovné pridanie hodnoty ju presunie na koniec; môže teda byť navštívená znova, ak už bolo jej predchádzajúce umiestnenie prečítané. Počas iterácie sa vyhnite nekontrolovanému pridávaniu.
Predvolene odkazujú Set.prototype.keys a Set.prototype[Symbol.iterator] na tú istú funkciu ako Set.prototype.values. Naproti tomu entries() vracia dvojice [value, value]. values() vyžaduje prijímateľa s internými údajmi Set; volanie na bežnom objekte alebo poli vyvolá TypeError.
Príklady
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()]));Výsledok
{"value":"a","done":false}
["b"]
{"done":true}
["a","b"]Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.