Map.prototype[Symbol.iterator]()

基线 广泛可用

此功能已得到很好的建立，并且可在许多设备和浏览器版本中使用。它自以下时间起在浏览器中可用： 2015 年 7 月.

[Symbol.iterator]() 方法是 Map 实例的 可迭代协议，并允许 Map 对象被大多数期望可迭代的语法使用，例如 扩展语法 和 for...of 循环。它返回一个 映射迭代器对象，该对象按插入顺序生成映射的键值对。

此属性的初始值与 Map.prototype.entries 属性的初始值相同。

试试看

语法

js
map[Symbol.iterator]()

参数

无。

返回值

与 Map.prototype.entries() 的返回值相同：一个新的 可迭代迭代器对象，它生成映射的键值对。

示例

使用 for...of 循环迭代

请注意，您很少需要直接调用此方法。[Symbol.iterator]() 方法的存在使 Map 对象 可迭代，并且像 for...of 循环这样的迭代语法会自动调用此方法以获取要循环的迭代器。

js
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() 方法以实现对迭代过程的最大控制。

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

规范

规范
ECMAScript 语言规范
# sec-map.prototype-%symbol.iterator%

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅