Die[Symbol.iterator]() Methode vonMap Instanzen implementiert dasiterable Protokoll und ermöglicht esMap Objekten, von den meisten Syntaxen verwendet zu werden, die Iterables erwarten, wie z.B. derSpread-Syntax undfor...of Schleifen. Sie gibt einMap-Iterator-Objekt zurück, das die Schlüssel-Wert-Paare der Map in Einfügereihenfolge liefert.

Der Anfangswert dieser Eigenschaft ist dasselbe Funktionsobjekt wie der Anfangswert derMap.prototype.entries Eigenschaft.

Probieren Sie es aus

const map = new Map();map.set("0", "foo");map.set(1, "bar");const iterator = map[Symbol.iterator]();for (const item of iterator) {  console.log(item);}// Expected output: Array ["0", "foo"]// Expected output: Array [1, "bar"]

Syntax

map[Symbol.iterator]()

Parameter

Keine.

Rückgabewert

Der gleiche Rückgabewert wieMap.prototype.entries(): ein neuesiterables Iterator-Objekt, das die Schlüssel-Wert-Paare der Map liefert.

Beispiele

Iteration mit for...of Schleife

Beachten Sie, dass Sie diese Methode selten direkt aufrufen müssen. Das Vorhandensein der[Symbol.iterator]() Methode machtMap Objekteiterierbar, und iterierende Syntaxen wie diefor...of Schleife rufen diese Methode automatisch auf, um den Iterator zu erhalten, über den sie iterieren können.

const myMap = new Map();myMap.set("0", "foo");myMap.set(1, "bar");myMap.set({}, "baz");for (const entry of myMap) {  console.log(entry);}// ["0", "foo"]// [1, "bar"]// [{}, "baz"]for (const [key, value] of myMap) {  console.log(`${key}: ${value}`);}// 0: foo// 1: bar// [Object]: baz

Manuelles Durchlaufen des Iterators

Sie können dennoch manuell dienext() Methode des zurückgegebenen Iterator-Objekts aufrufen, um maximale Kontrolle über den Iterationsprozess zu erreichen.

const myMap = new Map();myMap.set("0", "foo");myMap.set(1, "bar");myMap.set({}, "baz");const mapIter = myMap[Symbol.iterator]();console.log(mapIter.next().value); // ["0", "foo"]console.log(mapIter.next().value); // [1, "bar"]console.log(mapIter.next().value); // [Object, "baz"]

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Map
• Map.prototype.entries()
• Map.prototype.keys()
• Map.prototype.values()
• Symbol.iterator
• Iterationsprotokolle