WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Set.prototype.keys() — ein Iterator über Set-Werte

Set.prototype.keys() gibt einen neuen Iterator über die Werte eines Sets in Einfügereihenfolge zurück. Es liefert weder Indizes noch ein Array: Bei einem Set bezeichnen Schlüssel und Werte dieselben Elemente.

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

set.keys() benötigt keine Argumente und gibt einen neuen Iterator über die Werte des Sets in Einfügereihenfolge zurück. Ein Set hat keine separaten Schlüssel oder Indizes. In der unveränderten Standardbibliothek verweisen Set.prototype.keys und Set.prototype.values auf dieselbe Funktion; der Name keys sorgt für Konsistenz mit der Map-Schnittstelle.

Der Iterator ist kein Array. Ein Aufruf von next() rückt ihn um ein Element weiter, während [...iterator] seine verbleibenden Elemente in einem Array sammelt. Ist der Iterator erschöpft, gibt next() ein Ergebnis mit done: true zurück. Ein erneuter Aufruf von set.keys() erstellt einen unabhängigen Iterator.

Der Iterator ist keine Momentaufnahme: Ein Element, das vor seinem Besuch gelöscht wird, wird übersprungen; ein Element, das vor dem Ende der Iteration hinzugefügt wird, kann besucht werden. Wird die Methode mit einem this-Wert aufgerufen, dem die internen Set-Daten fehlen, wird ein TypeError ausgelöst.

Im Beispiel erzeugt das wiederholte "red" kein zweites Element. Der erste Aufruf von next() liefert "red", sodass das mit der Spread-Syntax [...iterator] erzeugte Array nur noch "blue" enthält.

Beispiele

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

Ergebnis

true
red
blue
true

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