JavaScript迭代器怎么用？如何自定义可迭代对象

本篇文章向大家介绍《JavaScript迭代器是什么？如何自定义可迭代对象》，主要包括，具有一定的参考价值，需要的朋友可以参考一下。

JavaScript迭代器是一套协议，要求对象具有返回{value, done}对象的next()方法；可迭代对象则需实现[Symbol.iterator]方法以返回迭代器。

JavaScript 迭代器是什么：它不是对象，而是一个协议

迭代器（Iterator）在 JavaScript 中不是一个内置类或类型，而是一套约定：只要一个对象有 next() 方法，且该方法返回形如 { value: any, done: boolean } 的对象，它就是迭代器。这个协议被 for...of、Array.from()、展开运算符（[...iterable]）等消费。

注意：迭代器本身不一定是可迭代的（即不能直接用于 for...of），只有「可迭代对象（Iterable）」才支持。两者的区别常被混淆：

• Iterator：有 next() 方法，一次吐一个值
• Iterable：有 [Symbol.iterator]() 方法，调用后返回一个 Iterator

如何让自定义对象变成可迭代对象：必须实现 [Symbol.iterator]

要让一个对象能被 for...of 遍历，你得给它加一个名为 [Symbol.iterator] 的方法（注意方括号是语法必需的，不是数组）。这个方法必须返回一个符合迭代器协议的对象。

常见错误写法：obj.iterator = function() { ... } —— 这不会被 for...of 识别，必须用 Symbol.iterator 这个键名。

示例：一个简单计数器，从 0 到 2：

const counter = {
  [Symbol.iterator]() {
    let i = 0;
    return {
      next() {
        if (i for (const n of counter) {
console.log(n); // 输出 0, 1, 2
}

自定义可迭代对象时容易踩的坑

实际写的时候，这几个点最容易出问题：

• next() 必须每次调用都返回新对象，不能复用同一个对象引用（否则 value 和 done 可能被意外修改）
• [Symbol.iterator] 必须是无参函数，且每次调用都应返回**新的迭代器实例**（否则多次遍历会共享状态，比如重复遍历时直接 done: true）
• 如果迭代逻辑依赖外部状态（如数组索引），确保闭包捕获的是当前迭代器的私有变量，而不是共享的父作用域变量
• 不要在 next() 中抛错来表示结束——必须靠 done: true；否则 for...of 会中断并报错

更实用的模式：用生成器函数替代手写 next()

手写 next() 容易出错且啰嗦。绝大多数场景下，直接用生成器函数（function*）是最简、最可靠的方式——它天然返回符合协议的迭代器。

上面的计数器用生成器重写：

const counter = {
  [Symbol.iterator]: function* () {
    for (let i = 0; i <p>生成器自动处理了 <code>value</code>/<code>done</code> 的组合、状态隔离、以及 <code>return</code> / <code>throw</code> 的兼容性。除非你需要精细控制迭代器的生命周期（比如手动暂停/恢复或注入外部事件），否则别手写 <code>next()</code>。</p><p>真正难的不是“怎么写”，而是想清楚：你的数据结构是否天然支持按需拉取？是否需要支持多次遍历？这些决定了你该返回一个新生成器，还是缓存一个已创建的迭代器。</p><p>以上就是《JavaScript迭代器怎么用？如何自定义可迭代对象》的详细内容，更多关于的资料请关注golang学习网公众号！</p>