17370845950

JavaScript迭代器是遵循特定协议的函数对象，必须有next()方法并返回{value, done}对象，支持按需生成值；可迭代对象则需实现[Symbol.iterator]方法并返回迭代器。

JavaScript 迭代器（Iterator）到底是什么？

迭代器不是语法糖，也不是对象类型，而是一个**约定接口的函数对象**：它必须有 next() 方法，每次调用返回一个形如 { value: ..., done: true|false } 的对象。只要满足这个协议，任何对象都可以是迭代器。

关键点在于「按需生成」——next() 不是预计算全部值，而是每次只产出下一个值，这对处理大数据流、无限序列或异步数据特别有用。

• done: true 表示迭代结束，之后再调用 next() 仍应返回 { value: undefined, done: true }
• 迭代器本身不一定要可重复使用；多数原生迭代器（如数组的 [Symbol.iterator]()）只支持单次遍历
• 不能直接 for...of 一个裸迭代器对象，必须先确保它符合「可迭代协议」（见下节）

哪些对象是可迭代对象（Iterable）？

可迭代对象 ≠ 迭代器，而是指实现了 [Symbol.iterator] 方法的对象，该方法必须返回一个迭代器。只有可迭代对象才能用于 for...of、展开运算符 [...iterable]、解构、Array.from() 等场景。

常见可迭代对象包括：

• 数组 []、字符串 "abc"、TypedArray（如 Uint8Array）
• Map、Set、WeakMap、WeakSet（注意：WeakMap/WeakSet 不可枚举，但仍是可迭代对象）
• arguments 对象、NodeList（DOM 查询结果，如 document.querySelectorAll('div')）
• Generator 函数返回值（天生可迭代，且自身就是迭代器）
• 自定义对象：只要手动挂上 [Symbol.iterator]() { return {...} } 就行

反例：普通对象 {}、null、undefined、Promise、Function 默认都不是可迭代对象，直接用于 for...of 会报 TypeError: xxx is not iterable。

如何手写一个可迭代对象？

核心就两步：1）定义 [Symbol.iterator] 方法；2）该方法返回一个符合迭代器协议的对象。下面是一个计数器示例，生成 0 到 2 的整数：

const counter = {
  [Symbol.iterator]() {
    let i = 0;
    return {
      next() {
        if (i < 3) {
          return { value: i++, done: false };
        } else {
          return { value: undefined, done: true };
        }
      }
    };
  }
};

for (const num of counter) {
  console.log(num); // 0, 1, 2
}

注意点：

• 不要在 [Symbol.iterator] 外层保存状态（如 let i = 0 放在对象字面量外），否则多个 for...of 循环会共享状态，导致不可预期行为
• 如果想支持多次遍历，每次调用 [Symbol.iterator] 都应返回一个**新迭代器实例**
• 若需异步迭代，要用 [Symbol.asyncIterator] 和 async function*，那是另一套协议

常见错误：为什么 Map/Set 的 key 是可迭代的，但 Object 不是？

因为 Map.prototype.keys()、Set.prototype.values() 等方法返回的是迭代器对象，而 Object 没有内置 [Symbol.iterator] 方法。你不能写 for (const key of {}) {...}，但可以写 for (const key of Object.keys({})) {...} —— 因为 Object.keys() 返回的是数组，数组是可迭代的。

容易混淆的点：

• Object.entries(obj) 返回数组，所以可直接 for...of；但 obj 本身不行
• Map 和 Set 的迭代顺序是插入顺序；Object 的 keys() 在 ES2015+ 也保证属性插入顺序（仅限字符串/符号键，不含数字键排序干扰）
• 试图对 JSON.parse() 后的普通对象用展开运算符会失败：{...obj} 合法，但 [...obj] 报错，因为后者触发可迭代协议检查

真正需要遍历对象时，别硬凑迭代器，优先用 Object.keys()、Object.values()、Object.entries()，它们稳定、语义清晰，且返回的数组天然可迭代。