Map.prototype[Symbol.iterator]()
[Symbol.iterator]() 方法是 Map 例項的一部分，它實現了 可迭代協議，允許 Map 物件被大多數期望可迭代物件的語法（如 展開語法 和 for...of 迴圈）使用。它返回一個 Map 迭代器物件，該物件按插入順序產生 Map 的鍵值對。
此屬性的初始值與 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"]
語法
js
map[Symbol.iterator]()
引數
無。
返回值
與 Map.prototype.entries() 返回相同的值：一個新的 可迭代迭代器物件，它產生 Map 的鍵值對。
示例
使用 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® 2026 語言規範 # sec-map.prototype-%symbol.iterator% |
瀏覽器相容性
載入中…