JavaScript自定义迭代器支持手动return的关键是将return方法定义在[Symbol.iterator]()返回的迭代器对象上，用于资源清理和提前终止；它需幂等、返回{done:true}，且生成器函数自动提供该方法。
JavaScript 中自定义迭代器要支持手动 return，关键在于让迭代器对象的 return 方法被正确调用，并确保它能清理资源、提前终止迭代。这在 for...of 循环被 break、continue 或异常中断时尤其重要。
迭代器协议要求实现 return 方法
根据 ES6 迭代器协议，一个完整的迭代器对象（即 next() 返回的对象）本身不需有 return；但**可选的 return 方法必须定义在迭代器对象（即 [Symbol.iterator]() 的返回值）上**。当外部提前退出循环时，引擎会检查该迭代器是否有 return 方法，若有则调用它。
- 该方法接收零个参数，应返回一个符合迭代器协议的对象（即带
done: true和可选value的对象） - 它通常用于释放资源（如关闭文件句柄、取消定时器、清理事件监听等）
- 如果没实现
return，提前退出时就不会触发清理逻辑
在生成器函数中自动获得 return
使用 function* 定义的生成器函数，其返回的迭代器**默认自带 return 方法**，且会执行到 yield 之后的清理逻辑（比如 try...finally 块）：
function* counter() {
try {
yield 1;
yield 2;
yield 3;
} finally {
console.log('cleanup: iterator returned early');
}
}
<p>const it = counter();
it.next(); // { value: 1, done: false }
it.return(); // → 触发 finally，输出日志，返回 { value: undefined, done: true }
注意：it.return() 可由引擎自动调用（如 for...of 遇 break），也可手动调用。
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
立即学习“Java免费学习笔记（深入）”；
手写迭代器时显式添加 return
若不用生成器，而是手动返回迭代器对象，需自行挂载 return 方法：
function createRangeIterator(start, end) {
let current = start;
let closed = false;
<p>const iterator = {
next() {
if (closed || current >= end) {
return { value: undefined, done: true };
}
return { value: current++, done: false };
},
return() {
closed = true; // 标记已关闭
console.log('manual cleanup done');
return { value: undefined, done: true };
},
[Symbol.iterator]() {
return this;
}
};</p><p>return iterator;
}</p><p>// 使用示例
const it = createRangeIterator(0, 5);
for (const val of it) {
console.log(val);
if (val === 2) break; // 提前退出 → 触发 return()
}
// 输出：0, 1, 2，然后打印 'manual cleanup done'
-
return()应幂等：多次调用不应出错，可用标志位（如closed）避免重复清理 - 返回对象必须含
done: true，value可为任意值（常为undefined） - 务必在
[Symbol.iterator]()返回的对象上定义return，而不是在类原型或工厂函数上
注意：return 不会跳过后续 next()
调用 return() 后，迭代器进入“完成”状态，后续所有 next() 调用都应返回 { done: true }。它不会“撤销”上一次 next()，也不会影响已产生的值，只负责终结和清理。
- 已调用过的
next()结果不受影响 - 调用
return()后再调用next()，应始终返回{ done: true } - 引擎不保证
return()一定被调用（例如直接丢弃迭代器对象），所以关键资源仍建议配合其他机制兜底
