CKTIS / JavaScript
Set.prototype.entries() — iterátor dvojic hodnot
Set.prototype.entries() vrací iterátor dvojic [value, value] v pořadí vložení. První pozice není index: Set neukládá samostatné klíče. Iterátor lze procházet pomocí next(), for...of nebo syntaxe spread.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
set.entries()Set.prototype.entries() nepřijímá žádné argumenty a vrací nový iterátor. Každá vrácená položka je nové dvouprvkové pole [value, value]. Obě pozice obsahují stejnou hodnotu; u objektu odkazují na tentýž objekt, nikoli na kopie. Tento formát odpovídá dvojicím vraceným metodou Map.prototype.entries(), ale Set nemá samostatné klíče ani indexy.
Prvky se procházejí v pořadí vložení. set.values() a výchozí iterace přes set vracejí jednotlivé hodnoty, zatímco set.entries() vrací dvojice. Metoda vyžaduje příjemce s interními daty Set; při zavolání na běžném objektu vyvolá TypeError.
Iterátor není snímek: vynechá prvky odstraněné před jejich navštívením a může zahrnout prvky přidané před dokončením iterace. Čtením se iterátor spotřebovává; po vyčerpání mají další volání next() hodnotu done: true. Metoda sama množinu nemění.
V příkladu opakované "red" nevytvoří další prvek množiny. První volání next() získá dvojici pro "red" a [...iterator] shromáždí pouze zbývající dvojici pro "blue".
Pří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ýsledek
["red","red"] [["blue","blue"]] true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.