Generator 的 return() 方法可立即终止生成器并返回指定值,状态变为 done: true;它不依赖 yield、跳过后续代码(但执行 try...finally 中的 finally),且后续调用均返回 { value: undefined, done: true }。

Generator 的 return() 方法可以立即结束生成器执行,并返回指定值,同时将生成器状态设为 done: true。它不依赖 yield 表达式,也不受当前暂停位置限制,是主动退出的可靠方式。
return() 的基本行为与触发时机
调用 generator.return(value) 会:
- 立即终止生成器函数的执行(跳过后续所有代码,包括
finally块以外的清理逻辑) - 返回一个形如
{ value: value, done: true }的对象 - 此后再调用
next()、throw()或return()都只会返回{ value: undefined, done: true }
注意:如果生成器内部有 try...finally,return() 仍会进入 finally 块 —— 这是唯一能保证运行的清理路径。
在条件满足时主动退出的典型写法
常见场景是外部控制流需要中断迭代,例如超时、取消信号或业务规则拦截:
function* fetchData() {
yield 'connecting';
yield 'fetching data...';
yield 'parsing response';
yield 'validating result';
}
<p>const gen = fetchData();
console.log(gen.next()); // { value: 'connecting', done: false }</p><p>// 某些条件成立,立刻退出
if (shouldAbort()) {
console.log(gen.return('aborted')); // { value: 'aborted', done: true }
}
</p>
此时后续 gen.next() 调用始终返回 { value: undefined, done: true }。
结合 Promise 与 abort signal 的实用封装
在异步生成器中,可配合 AbortController 实现响应式退出:
async function* fetchStream(signal) {
try {
for await (const chunk of someAsyncIterable()) {
if (signal.aborted) {
return 'stream cancelled';
}
yield chunk;
}
} finally {
// 清理资源
}
}
<p>// 外部也可直接调用 return()
const gen = fetchStream(controller.signal);
gen.return('forced exit'); // 立即结束,无需等待异步操作
</p>
虽然异步生成器自身支持 return(),但需注意:它会拒绝当前 pending 的 promise,且不会等待 finally 中的异步操作完成。
与 throw() 和 return 的区别要点
三者都可提前终止生成器,但语义不同:
-
throw(error):模拟异常抛出,会沿生成器调用栈向上冒泡,可被try...catch捕获 -
return(value):正常退出,不触发错误处理逻辑,适合“完成但非成功”的语义(如取消、超时) -
next(value)不带参数或传undefined:继续执行到下一个yield;传值则会作为上一个yield表达式的返回结果
选择 return() 的关键在于你希望表达“主动终结”,而非“出错中断”或“继续流转”。










