Array.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 May 2018.
Array 实例的 [Symbol.iterator]() 方法实现了可迭代协议，允许数组被大多数期望可迭代对象的语法所使用，例如展开语法和 for...of 循环。它返回一个数组迭代器对象，该对象会产生数组中每个索引的值。
该属性的初始值与 Array.prototype.values 属性的初始值是相同的函数对象。
尝试一下
const array1 = ["a", "b", "c"]; const iterator1 = array1[Symbol.iterator](); for (const value of iterator1) { console.log(value); } // Expected output: "a" // Expected output: "b" // Expected output: "c" 语法
js
array[Symbol.iterator]() 返回值
与 Array.prototype.values() 相同的返回值：一个新的可迭代迭代器对象，它会生成数组中每个索引的值。
示例
使用 for...of 循环进行迭代
请注意，你很少需要直接调用此方法。[Symbol.iterator]() 方法的存在使数组可迭代，并且像 for...of 循环这样的迭代语法会自动调用此方法以获得要遍历的迭代器。
HTML
html
<ul id="letterResult"></ul> JavaScript
js
const arr = ["a", "b", "c"]; const letterResult = document.getElementById("letterResult"); for (const letter of arr) { const li = document.createElement("li"); li.textContent = letter; letterResult.appendChild(li); } 结果
手动执行迭代器
你仍然可以手动调用返回迭代器对象的 next() 方法，以实现对迭代过程的最大控制。
js
const arr = ["a", "b", "c", "d", "e"]; const arrIter = arr[Symbol.iterator](); console.log(arrIter.next().value); // a console.log(arrIter.next().value); // b console.log(arrIter.next().value); // c console.log(arrIter.next().value); // d console.log(arrIter.next().value); // e 使用相同的函数处理字符串和字符串数组
因为字符串和数组都实现了可迭代协议，所以可以设计一个通用函数以相同的方式处理这两种输入。这比直接调用 Array.prototype.values() 更好，后者要求输入是一个数组，或者至少是一个具有这种方法的对象。
js
function logIterable(it) { if (typeof it[Symbol.iterator] !== "function") { console.log(it, "不可迭代。"); return; } for (const letter of it) { console.log(letter); } } // 数组 logIterable(["a", "b", "c"]); // a // b // c // 字符串 logIterable("abc"); // a // b // c // 数值 logIterable(123); // 123 不可迭代。 规范
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-array.prototype-%symbol.iterator% |
