CKTIS / JavaScript
Set.prototype.keys() — iterátor hodnot množiny
Set.prototype.keys() vrací nový iterátor hodnot množiny v pořadí, v jakém byly přidány. Nevrací indexy ani pole: v objektu Set označují klíče a hodnoty stejné prvky.
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.keys()set.keys() nevyžaduje žádné argumenty a vrací nový iterátor hodnot množiny v pořadí, v jakém byly přidány. Set nemá samostatné klíče ani indexy. V nezměněné standardní knihovně odkazují Set.prototype.keys a Set.prototype.values na stejnou funkci; název keys zajišťuje konzistenci s rozhraním Map.
Iterátor není pole. Volání next() jej posune o jeden prvek, zatímco [...iterator] shromáždí zbývající prvky do pole. Po vyčerpání vrátí next() výsledek s done: true. Opětovné zavolání set.keys() vytvoří nezávislý iterátor.
Iterátor není snímek množiny: prvek odstraněný před návštěvou se přeskočí a prvek přidaný před dokončením iterace může být navštíven. Zavolání metody s hodnotou this, která nemá interní data Set, vyvolá TypeError.
V příkladu opakované "red" nevytvoří druhý prvek. První volání next() získá "red", takže po rozbalení iterátoru zůstane pouze "blue".
Příklady
const colors = new Set(["red", "blue", "red"]);
const iterator = colors.keys();
console.log(Set.prototype.keys === Set.prototype.values);
console.log(iterator.next().value);
console.log([...iterator].join(","));
console.log(iterator.next().done);Výsledek
true red 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.