Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje