JavaScript迭代器是具有next()方法并返回{value, done}对象的对象，用于按需提供序列值；可迭代对象则需实现Symbol.iterator方法以返回迭代器。
JavaScript 迭代器（Iterator）是一个具有 next() 方法的对象，该方法返回形如 { value: any, done: boolean } 的结果对象。它用来按需逐个提供序列中的值，是 for...of、解构赋值、扩展运算符（...）等语法背后的机制。
迭代器协议与可迭代协议的区别
两者常被混淆，但职责不同：
-
迭代器协议（Iterator Protocol）：定义一个对象只要拥有符合规范的
next()方法，就是迭代器。 -
可迭代协议（Iterable Protocol）：定义一个对象只要拥有名为
Symbol.iterator的方法，且该方法返回一个迭代器，这个对象就是“可迭代的”（iterable）。
也就是说：可迭代对象 → 调用 [Symbol.iterator]() → 得到一个迭代器 → 用 next() 一步步取值。
让自定义对象变成可迭代对象
只需在对象上定义 [Symbol.iterator] 方法，并确保它返回一个满足迭代器协议的对象。最简单的方式是返回一个生成器函数（function*），因为生成器函数自动实现 next()。
立即学习“Java免费学习笔记（深入）”；
例如，让一个类表示的“书架”支持 for...of 遍历其中的书名：
class BookShelf {
constructor(books) {
this.books = books;
}
*[Symbol.iterator]() {
for (const book of this.books) {
yield book.title;
}
}
}
const shelf = new BookShelf([
{ title: 'Eloquent JavaScript', author: 'Marijn Haverbeke' },
{ title: 'You Don’t Know JS', author: 'Kyle Simpson' }
]);
for (const title of shelf) {
console.log(title); // 'Eloquent JavaScript', 'You Don’t Know JS'
}
手动实现迭代器（不依赖生成器）
如果需要精细控制状态或兼容老环境（不支持生成器），可以手动返回一个带 next() 的对象：
class BookShelf {
constructor(books) {
this.books = books;
}
[Symbol.iterator]() {
let index = 0;
const books = this.books;
return {
next() {
if (index < books.length) {
return { value: books[index++].title, done: false };
} else {
return { value: undefined, done: true };
}
}
};
}
}
注意：done: true 时 value 可省略，但显式返回 undefined 更清晰；每次调用 next() 应独立于其他迭代器实例（即多个 for...of 同时遍历时互不影响），所以状态（如 index）必须封装在闭包或迭代器对象内部。
常见误区与建议
-
不要直接在实例上挂
next()：仅实现next()不代表可迭代，必须通过[Symbol.iterator]暴露入口。 -
避免共享迭代状态：如果多个地方同时遍历同一个对象，应每次调用
[Symbol.iterator]都返回**新**的迭代器对象，而不是复用同一个。 -
可迭代不等于数组：可迭代对象不能直接调用
.map()、.filter()等数组方法，需先转成数组（Array.from(it)或[...it]）再操作。 -
空迭代器要返回
{ done: true }：即使没有数据，[Symbol.iterator]().next()也应立刻返回{ done: true }，否则for...of会无限循环。
不复杂但容易忽略。核心就两点：加 [Symbol.iterator] 方法，让它返回一个有正确 next() 的对象。
