CKTIS / JavaScript
Set.prototype.entries() — iterátor dvojíc hodnôt
Set.prototype.entries() vracia iterátor dvojíc [value, value] v poradí vloženia. Prvá pozícia nie je index: Set neukladá samostatné kľúče. Iterátor možno prechádzať pomocou next(), for...of alebo syntaxe spread.
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.entries()Set.prototype.entries() neprijíma žiadne argumenty a vracia nový iterátor. Každá vrátená položka je nové dvojprvkové pole [value, value]. Obe pozície obsahujú rovnakú hodnotu; pri objekte odkazujú na ten istý objekt, nie na kópie. Tento formát zodpovedá dvojiciam vracaným metódou Map.prototype.entries(), ale Set nemá samostatné kľúče ani indexy.
Prvky sa prechádzajú v poradí vloženia. set.values() a predvolená iterácia cez set vracajú jednotlivé hodnoty, zatiaľ čo set.entries() vracia dvojice. Metóda vyžaduje prijímateľa s internými údajmi Set; pri zavolaní na bežnom objekte vyvolá TypeError.
Iterátor nie je snímka: vynechá prvky odstránené pred ich navštívením a môže zahrnúť prvky pridané pred dokončením iterácie. Čítaním sa iterátor spotrebúva; po vyčerpaní majú ďalšie volania next() hodnotu done: true. Metóda sama množinu nemení.
V príklade opakované "red" nevytvorí ďalší prvok množiny. Prvé volanie next() získa dvojicu pre "red" a [...iterator] zhromaždí iba zostávajúcu dvojicu pre "blue".
Príklady
const set = new Set(["red", "blue", "red"]);
const iterator = set.entries();
console.log(JSON.stringify(iterator.next().value));
console.log(JSON.stringify([...iterator]));
console.log(iterator.next().done);Výsledok
["red","red"] [["blue","blue"]] true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.