生成器函数用function声明,调用返回迭代器而非执行函数体;需调用next()启动并逐次暂停于yield,yield可传值并保持上下文,yield委托可迭代对象,return()/throw()可提前终止并触发finally。
生成器函数不是普通函数,它必须用 function* 语法声明,调用后返回一个迭代器对象,而不是直接执行函数体。这个迭代器对象有 next() 方法,每次调用才会推进到下一个 yield 表达式。
常见错误是把它当普通函数调用:myGenerator() 不会打印任何东西,也不会暂停——它只返回一个未启动的迭代器。
function* gen() { ... },星号紧贴 function 关键字(function *gen() 也合法,但不推荐)const it = gen() 得到迭代器,此时函数体尚未执行it.next() 才开始执行,直到遇到第一个 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() 的参数会被忽略(规范要求)。
当需要把控制权“转交”给另一个生成器或数组、字符串等可迭代对象时,用 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():错误会先传给内层生成器,只有它没捕获时,才冒泡到外层。这点调试时很容易误判错误来源。