生成器函数用function声明,调用返回迭代器而非执行函数体;需调用next()启动并逐次暂停于yield,yield可传值并保持上下文,yield委托可迭代对象,return()/throw()可提前终止并触发finally。

JavaScript 生成器函数怎么定义和调用
生成器函数不是普通函数,它必须用 function* 语法声明,调用后返回一个迭代器对象,而不是直接执行函数体。这个迭代器对象有 next() 方法,每次调用才会推进到下一个 yield 表达式。
常见错误是把它当普通函数调用:myGenerator() 不会打印任何东西,也不会暂停——它只返回一个未启动的迭代器。
- 定义:必须写成
function* gen() { ... },星号紧贴function关键字(function *gen()也合法,但不推荐) - 调用:
const it = gen()得到迭代器,此时函数体尚未执行 - 启动:第一次调用
it.next()才开始执行,直到遇到第一个yield暂停
yield 是如何暂停并传递值的
yield 不是“返回然后结束”,而是“产出值、暂停执行、保持当前上下文(包括变量、作用域链、执行位置)”。下次调用 next() 时,从暂停处继续,且上一次 yield 表达式的值等于本次 next() 传入的参数。
function* counter() {
let i = 0;
while (true) {
const step = yield i;
i += step ?? 1;
}
}
const it = counter();
it.next(); // { value: 0, done: false }
it.next(2); // { value: 2, done: false } ← 2 被赋给 step
it.next(); // { value: 3, done: false } ← step 是 undefined,用默认值 1
注意:yield 表达式本身有返回值,但它只在下一次 next(arg) 调用时才被赋值。首次 next() 的参数会被忽略(规范要求)。
立即学习“Java免费学习笔记(深入)”;
yield* 用来委托另一个可迭代对象
当需要把控制权“转交”给另一个生成器或数组、字符串等可迭代对象时,用 yield*。它会逐个 yield 被委托对象的每个值,并等待其完全耗尽后再继续后续代码。
-
yield* [1, 2, 3]等价于手动写三个yield 1; yield 2; yield 3; -
yield* anotherGenerator()会启动该生成器,并将它的所有产出值透传出来 - 如果被委托对象不是可迭代的(比如
null或普通对象),会抛出TypeError: x is not iterable
性能上,yield* 是语法糖,但比手动循环 for...of + yield 更简洁,且能正确处理异步生成器委托(配合 async function*)。
生成器退出和异常处理容易被忽略的点
生成器可以被提前终止(例如调用 return() 或 throw()),这时会跳过剩余 yield,触发 finally 块(如果有),并立即返回 { done: true } 结果。
-
it.return(value):立即结束生成器,返回{ value, done: true },触发finally -
it.throw(error):在暂停位置抛出错误,可被内部try...catch捕获;若未捕获,则生成器终止 - 一旦
done: true,再调用next()、return()或throw()都只会返回{ value: undefined, done: true }
真正复杂的是嵌套委托(yield* inner())中调用 throw():错误会先传给内层生成器,只有它没捕获时,才冒泡到外层。这点调试时很容易误判错误来源。











