WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Set.prototype.values() — Iterator über die Werte einer Menge

Die Methode values() gibt einen neuen Iterator über die Werte eines Set in Einfügereihenfolge zurück. Sie erstellt weder ein Array noch eine Kopie der Menge; jeder Lesezugriff schreitet im Iterator weiter, und Änderungen an der Menge können den verbleibenden Durchlauf beeinflussen.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

set.values()

Set.prototype.values() wird ohne Argumente als set.values() aufgerufen. Die Methode gibt einen neuen Iterator über die Werte in Einfügereihenfolge zurück, kein Array. Der Aufruf selbst ändert die Menge nicht. Wird ein bereits vorhandener Wert erneut hinzugefügt, entsteht weder ein Duplikat noch ändert sich seine Position.

Die Methode next() des Iterators gibt ein Objekt mit den Eigenschaften value und done zurück. Nach dem Ausschöpfen des Iterators lauten diese undefined beziehungsweise true; weitere Aufrufe starten den Durchlauf nicht erneut. Für einen neuen Durchlauf ist ein weiterer Aufruf von set.values() erforderlich. Der Iterator unterstützt for...of und [...iterator], wobei die Spread-Syntax seine verbleibenden Elemente verbraucht.

Der Iterator ist keine Momentaufnahme: Werte, die vor ihrem Besuch gelöscht werden, werden übersprungen; Werte, die vor dem Ende des Durchlaufs hinzugefügt werden, können besucht werden. Wird ein Wert gelöscht und erneut hinzugefügt, landet er am Ende. Daher kann er erneut besucht werden, wenn sein früheres Vorkommen bereits gelesen wurde. Vermeide unkontrolliertes Hinzufügen während der Iteration.

Standardmäßig verweisen Set.prototype.keys und Set.prototype[Symbol.iterator] auf dieselbe Funktion wie Set.prototype.values. entries() gibt dagegen Paare der Form [value, value] zurück. values() setzt einen Empfänger mit internen Set-Daten voraus; ein Aufruf für ein gewöhnliches Objekt oder ein Array löst einen TypeError aus.

Beispiele

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()]));

Ergebnis

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

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen