Map.prototype[Symbol.iterator]()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2016.

Die Methode [Symbol.iterator]() von Map Instanzen implementiert das iterable Protokoll und ermöglicht Map-Objekten, von den meisten Syntaxen, die Iterables erwarten, wie etwa der Spread-Syntax und for...of Schleifen, genutzt zu werden. Sie gibt ein Map-Iterator-Objekt zurück, das die Schlüssel-Werte-Paare der Map in Einfügereihenfolge liefert.

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

Probieren Sie es aus

const map1 = new Map();

map1.set("0", "foo");
map1.set(1, "bar");

const iterator1 = map1[Symbol.iterator]();

for (const item of iterator1) {
  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 wie Map.prototype.entries(): ein neues iterables Iterator-Objekt, das die Schlüssel-Werte-Paare der Map liefert.

Beispiele

Iteration mit der for...of Schleife

Beachten Sie, dass Sie diese Methode selten direkt aufrufen müssen. Die Existenz der [Symbol.iterator]() Methode macht Map-Objekte iterierbar, und iterierende Syntaxen wie die for...of Schleife rufen diese Methode automatisch auf, um den Iterator zum Schleifen zu erhalten.

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 Erstellen des Iterators

Sie können dennoch die next() Methode des zurückgegebenen Iterator-Objekts manuell 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

Specification
ECMAScript® 2026 Language Specification # sec-map.prototype-%symbol.iterator%