WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Set.prototype.entries() — ein Iterator von Wertepaaren

Set.prototype.entries() gibt einen Iterator mit [value, value]-Paaren in Einfügereihenfolge zurück. Die erste Position ist kein Index: Set speichert keine separaten Schlüssel. Der Iterator lässt sich mit next(), for...of oder der Spread-Syntax auslesen.

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

Set.prototype.entries() akzeptiert keine Argumente und gibt einen neuen Iterator zurück. Jedes ausgegebene Element ist ein neues Array mit zwei Elementen: [value, value]. Beide Positionen enthalten denselben Wert; bei einem Objekt verweisen sie auf dasselbe Objekt und nicht auf Kopien. Dieses Format entspricht den von Map.prototype.entries() zurückgegebenen Paaren, aber ein Set hat keine separaten Schlüssel oder Indizes.

Die Elemente werden in Einfügereihenfolge besucht. set.values() und die standardmäßige Iteration über set liefern einzelne Werte, während set.entries() Paare liefert. Die Methode benötigt einen Empfänger mit internen Set-Daten; wird sie auf einem gewöhnlichen Objekt aufgerufen, wird ein TypeError ausgelöst.

Der Iterator ist keine Momentaufnahme: Er überspringt Elemente, die gelöscht wurden, bevor sie besucht werden, und kann Elemente einschließen, die vor dem Ende der Iteration hinzugefügt wurden. Das Auslesen verbraucht den Iterator; nach seiner Erschöpfung haben weitere Aufrufe von next() den Wert done: true. Die Methode selbst verändert das Set nicht.

Im Beispiel erzeugt das wiederholte "red" kein weiteres Set-Element. Der erste Aufruf von next() ruft das Paar für "red" ab, und [...iterator] sammelt nur das verbleibende Paar für "blue".

Beispiele

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

Ergebnis

["red","red"]
[["blue","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