Map.prototype[Symbol.iterator]()

Метод [Symbol.iterator]() экземпляров Map реализует протокол итерации и позволяет объектам Map потребляться большинством синтаксисов, ожидающих итерируемые объекты, таких как синтаксис spread и циклы for...of. Он возвращает объект итератора карты, который выдает пары ключ-значение карты в порядке вставки.

Начальное значение этого свойства — тот же объект функции, что и начальное значение свойства Map.prototype.entries.

Попробуйте

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"]

Синтаксис

map[Symbol.iterator]()

Параметры

Нет.

Возвращаемое значение

То же возвращаемое значение, что и у Map.prototype.entries(): новый итерируемый объект итератора, который выдает пары ключ-значение карты.

Примеры

Итерация с помощью цикла for...of

Обратите внимание, что вам редко нужно вызывать этот метод напрямую. Наличие метода [Symbol.iterator]() делает объекты Map итерируемыми, а синтаксисы итерации, такие как цикл for...of, автоматически вызывают этот метод для получения итератора для перебора.

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

Ручное создание итератора

Вы по-прежнему можете вручную вызывать метод next() возвращаемого объекта итератора для достижения максимального контроля над процессом итерации.

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"]

Спецификации

Совместимость с браузерами

См. также

• Map
• Map.prototype.entries()
• Map.prototype.keys()
• Map.prototype.values()
• Symbol.iterator
• Протоколы итерации