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

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.

Zdroje