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

CKTIS / JavaScript

Set.prototype.values() — iterátor hodnot množiny

Metoda values() vrací nový iterátor hodnot Set v pořadí jejich vložení. Nevytváří pole ani kopii množiny; každé čtení posouvá iterátor a změny množiny mohou ovlivnit zbývající průchod.

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.values()

Set.prototype.values() volejte bez argumentů jako set.values(). Vrací nový iterátor hodnot v pořadí jejich vložení, nikoli pole. Samotné volání množinu nemění. Opětovné přidání již existující hodnoty nevytvoří duplikát ani nezmění její pozici.

Metoda iterátoru next() vrací objekt s vlastnostmi value a done. Po vyčerpání iterátoru mají tyto vlastnosti hodnoty undefined a true; další volání průchod znovu nespustí. Nový průchod vyžaduje další volání set.values(). Iterátor podporuje for...of a [...iterator], které spotřebuje jeho zbývající prvky.

Iterátor není snímek: hodnoty odstraněné před návštěvou přeskočí a může navštívit hodnoty přidané před dokončením průchodu. Odstranění a opětovné přidání hodnoty ji přesune na konec; může tedy být navštívena znovu, pokud už bylo její předchozí umístění přečteno. Během iterace se vyhněte nekontrolovanému přidávání.

Ve výchozím nastavení odkazují Set.prototype.keys a Set.prototype[Symbol.iterator] na stejnou funkci jako Set.prototype.values. Naproti tomu entries() vrací dvojice [value, value]. values() vyžaduje příjemce s interními daty Set; volání na běžném objektu nebo poli vyvolá TypeError.

Příklady

const set = new Set(["a", "b", "a"]);
const iterator = set.values();

console.log(JSON.stringify(iterator.next()));
console.log(JSON.stringify([...iterator]));
console.log(JSON.stringify(iterator.next()));
console.log(JSON.stringify([...set.values()]));

Výsledek

{"value":"a","done":false}
["b"]
{"done":true}
["a","b"]

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