JavaScript迭代协议_可迭代对象创建

可迭代协议要求对象实现[Symbol.iterator]方法，该方法返回带有next()的迭代器，next()返回{value, done}对象，从而支持for...of和扩展运算符。

JavaScript 中的迭代协议让对象可以被 for...of 循环、展开运算符（...）以及其他期望可迭代数据的语法所使用。要创建一个可迭代对象，你需要遵循“可迭代协议”，即在对象上实现一个名为 [Symbol.iterator] 的方法。

什么是可迭代协议？

一个对象如果具有 [Symbol.iterator] 方法，就被认为是可迭代的。这个方法必须返回一个迭代器对象，而该迭代器需要有一个 next() 方法，用于逐步返回值。

• [Symbol.iterator]()：无参函数，返回一个迭代器
• 迭代器对象包含 next() 方法
• next() 返回形如 { value: 值, done: 布尔 } 的对象

手动创建一个可迭代对象

下面是一个简单的例子，创建一个能遍历数字 1 到 3 的可迭代对象：

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

// 使用 for...of 遍历
for (const num of myIterable) {
  console.log(num); // 输出 1, 2, 3
}

// 也可以用展开运算符
console.log([...myIterable]); // [1, 2, 3]

让自定义类成为可迭代对象

你可以将迭代协议应用到类中，使实例可被遍历。比如创建一个容器类，存储一些数据并支持迭代：

PaperFake

AI写论文

下载

立即学习“Java免费学习笔记（深入）”；

class NumberRange {
  constructor(start, end) {
    this.start = start;
    this.end = end;
  }

  [Symbol.iterator]() {
    let current = this.start;
    const limit = this.end;

    return {
      next() {
        if (current <= limit) {
          return { value: current++, done: false };
        } else {
          return { value: undefined, done: true };
        }
      }
    };
  }
}

const range = new NumberRange(5, 8);
for (const n of range) {
  console.log(n); // 输出 5, 6, 7, 8
}

常见用途与注意事项

可迭代对象广泛应用于数组、字符串、Map、Set 等原生类型。你也可以封装异步流程或自定义数据结构。

• 确保 [Symbol.iterator] 每次调用都返回一个新的迭代器，避免状态共享
• done 为 true 时，value 可省略或设为 undefined
• 可以实现 return() 或 throw() 方法处理提前退出（高级用法）