JavaScript生成器函数是可暂停执行的函数,返回迭代器对象;调用后需用next()推进执行,yield暂停并输出值,return终止并设done: true。

JavaScript 生成器函数不是“异步函数的简化写法”,它本质是**可暂停执行的函数,返回一个迭代器对象**。你调用它不会立即运行函数体,而是得到一个 Generator 实例,只有调用它的 next() 方法时,才从头或上次暂停处继续执行,直到遇到下一个 yield 或函数结束。
生成器函数定义与基本调用:必须用 function* 语法
生成器函数声明必须带星号(function*),这是硬性语法要求;箭头函数不支持生成器。调用后返回的是一个迭代器对象,不是普通函数返回值:
function* count() {
yield 1;
yield 2;
return 3;
}
const gen = count(); // 不执行函数体,只返回 Generator 对象
console.log(gen.next()); // { value: 1, done: false }
console.log(gen.next()); // { value: 2, done: false }
console.log(gen.next()); // { value: 3, done: true }-
yield暂停并输出值,return终止并设done: true - 多次调用
next()是推进执行的关键,不是“重跑函数” - 如果生成器已
done: true,后续next()仍返回{ value: undefined, done: true }
yield 可接收外部传入值:双向通信机制
yield 表达式本身是有返回值的——它等于下一次调用 next(arg) 时传入的参数。这是生成器实现协程式控制流的基础:
function* echo() {
const a = yield 'first';
console.log('a:', a); // a: 'hello'
const b = yield 'second';
console.log('b:', b); // b: 'world'
}
const it = echo();
console.log(it.next()); // { value: 'first', done: false }
console.log(it.next('hello')); // { value: 'second', done: false }
console.log(it.next('world')); // { value: undefined, done: true }- 首次
next()总是忽略传参,只启动执行到第一个yield - 后续
next(x)中的x成为上一个yield表达式的值 - 这个特性常被用于手写
co类库、模拟 async/await 的早期实现
生成器与 for...of 和扩展运算符配合:自动消费迭代器
生成器对象实现了 Symbol.iterator,因此天然支持 for...of、[...gen]、Array.from(gen) 等语法,但注意:它们**只会遍历 yield 的值,忽略 return 的终值**:
立即学习“Java免费学习笔记(深入)”;
function* nums() {
yield 1;
yield 2;
return 999; // 这个 999 不会被 for...of 捕获
}
for (const n of nums()) {
console.log(n); // 输出 1, 2 —— 不会输出 999
}
console.log([...nums()]); // [1, 2]-
for...of内部反复调用next()直到done: true,但只收集value字段 - 若需捕获
return值,必须手动调用next()并检查done - 生成器一旦
done,无法重置;如需重复使用,得重新调用生成器函数创建新实例
常见误用:把生成器当 Promise 用,或混淆 yield 与 await
生成器本身不处理异步,yield 后跟 Promise 不会自动等待;要实现类似 async/await,必须配合同步驱动器(如 co 库或手写 runner):
function* fetchUser() {
const res = yield fetch('/api/user'); // ❌ 这里 res 是 Promise 实例,不是响应结果
return res.json();
}
// 必须用 runner 包装才能真正 await:
function run(genFn) {
const it = genFn();
function next(val) {
const { value, done } = it.next(val);
if (done) return value;
return value.then(res => next(res)); // 手动 resolve Promise 并递归 next
}
return next();
}- 直接
yield Promise没有意义,JS 引擎不会自动await它 - 现代代码应优先用
async/await,生成器主要用于底层抽象(如 redux-saga)、状态机或需要精细控制执行节奏的场景 - 调试时注意:生成器函数在 DevTools 中断点可能跳转不直观,因实际执行分散在多次
next()调用中
生成器的核心价值不在“写起来多简洁”,而在于它把函数执行权交还给调用方——你可以决定何时推进、传什么数据、甚至中途注入异常(it.throw(err))。这种控制反转正是它难以被替代的地方,也是最容易被忽略的复杂性所在。











