Array.from仅通过Symbol.iterator协议识别可迭代对象,不依赖类型或类数组结构;只要对象拥有返回合法迭代器的[Symbol.iterator]方法,即可转换为数组。

识别迭代器协议与 Array.from 的自动对接机制,关键在于理解 Array.from 如何检测并消费对象——它不看类型,只认协议。
Array.from 只认 [Symbol.iterator] 方法
Array.from 会尝试调用目标对象的 [Symbol.iterator] 方法。只要该方法存在且返回一个合法迭代器(即含 next() 并返回 {value, done} 的对象),Array.from 就能将其转为数组。
- 原生类型如
Array、String、Set、Map.keys()都内置该方法,所以直接可用 - 自定义对象若未实现
[Symbol.iterator],Array.from(obj)会报错:TypeError: obj is not iterable - 即使对象有
length和数字索引(类数组),若没实现该方法,Array.from也不会按索引读取——它不走“类数组逻辑”,只走迭代器协议
迭代器必须支持多次遍历(或明确设计为单次)
Array.from 内部会反复调用迭代器的 next(),直到 done: true。因此:
- 如果迭代器状态不可重置(如闭包中
current只增不返),同一迭代器对象只能被Array.from正确使用一次 - 推荐让
[Symbol.iterator]每次都返回**新迭代器实例**,确保多次调用Array.from互不影响(如数组的values()就是这样) - 生成器函数返回的迭代器天然满足这一要求,因为每次调用生成器都产生全新迭代状态
Array.from 不处理“伪迭代器”
有些对象看似可遍历,但不符合协议细节,Array.from 会失败:
- 只实现了
next()但没挂载在[Symbol.iterator]返回的对象上 → 不识别 -
next()返回缺少done属性,或done类型不是布尔值 → 报错或无限循环 -
[Symbol.iterator]返回的不是对象(如返回null或数字)→TypeError: null is not an object
验证是否对接成功的简单方式
不用运行完整代码,三步快速判断:
- 执行
typeof obj[Symbol.iterator]—— 应为"function" - 执行
const it = obj[Symbol.iterator](); typeof it.next—— 应为"function" - 执行
it.next()—— 返回结果应是形如{value: ..., done: false}或{value: undefined, done: true}的对象
三项全满足,Array.from(obj) 就一定能用。

















