大网数据广告活动
Web 标准与前端开发

Iterator.from()

· 52CE 我爱测

**`Iterator.from()`** 静态方法从迭代器或可迭代对象创建一个新的 Iterator 对象。

Iterator.from() 静态方法从迭代器或可迭代对象创建一个新的 Iterator 对象。

语法

from(object)

参数

返回值

如果 object 是一个可迭代对象,则会调用其 [Symbol.iterator]() 以获取迭代器。否则,object 将被视为一个迭代器。如果该迭代器的 instanceof Iterator 结果为真(这意味着它在原型链中有 Iterator.prototype),则直接返回它。否则,创建一个包装了原始迭代器的新 Iterator 对象。

描述

这个方法的存在是为了将自定义迭代器(可能是由库导出的)转换为恰当的迭代器。所有由 Iterator.from() 返回的迭代器对象都继承自一个公共原型对象,该对象具有以下方法:

  • next()
    • : 调用底层迭代器的 next() 方法并返回结果。
  • return()
    • : 调用底层迭代器的 return() 方法并返回结果,如果底层迭代器没有 return() 方法,则返回 { value: undefined, done: true }。

示例

将可迭代对象转换为恰当的迭代器

因为 obj 已经是一个可迭代对象,并且其 [Symbol.iterator]() 方法返回了一个恰当的迭代器,所以 Iterator.from(obj) 返回的迭代器与 obj 相同。

const iterator = (function* () {
  yield 1;
  yield 2;
  yield 3;
})();

const obj = {
  [Symbol.iterator]() {
    return iterator;
  },
};

const iterator2 = Iterator.from(obj);
console.log(iterator2 === iterator); // true

因为 obj2 是一个可迭代对象,其 [Symbol.iterator]() 方法返回了一个非恰当的迭代器,所以 Iterator.from(obj2) 返回一个包装了原始迭代器的新迭代器。

const iterator = {
  current: 0,
  next() {
    return { value: this.current++, done: false };
  },
};

const obj2 = {
  [Symbol.iterator]() {
    return iterator;
  },
};

const iterator2 = Iterator.from(obj2);
console.log(iterator2 === iterator); // false
console.log(iterator2.next()); // { value: 0, done: false }
console.log(iterator.next()); // { value: 1, done: false }

将迭代器转换为恰当的迭代器

因为 obj 已经是一个恰当的迭代器,所以 Iterator.from(obj) 返回它本身。

const obj = (function* () {
  yield 1;
  yield 2;
  yield 3;
})();

const iterator = Iterator.from(obj);
console.log(iterator === obj); // true

因为 obj2 是一个非恰当的迭代器,所以 Iterator.from(obj2) 返回一个包装了原始迭代器的新迭代器。

const obj2 = {
  current: 0,
  next() {
    return { value: this.current++, done: false };
  },
};

const iterator = Iterator.from(obj2);
console.log(iterator === obj2); // false
console.log(iterator.next()); // { value: 0, done: false }
console.log(obj2.next()); // { value: 1, done: false }

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。