Generator函数测试核心是断言yield行为而非执行异步操作:验证yield值类型/参数、mock输入后的下一步yield或返回结果、错误处理逻辑;推荐手动迭代器驱动,co已过时,redux-saga等场景则专注effect对象断言。

Generator 函数本身不执行异步操作,它只是返回一个迭代器对象,需配合 co、redux-saga 或手动调用 next() 驱动执行。在现代 JS 测试中,**不推荐直接为 generator 函数写异步测试用例**——除非你正在维护旧项目(如基于 co 的逻辑)或测试 saga 等中间层。真正要测的是:generator 被正确驱动后,是否按预期 yield 正确的 effect(如 Promise、action、call 等),以及能否响应 mock 返回值。
明确测试目标:测 yield 行为,不是测“async”
Generator 函数(如 function* fetchData() { yield fetch('/api'); })不会自动发请求。测试重点是:
- 它 yield 了什么(类型、参数)
- 当传入 mock 值(如
it.next(mockResponse))后,是否 yield 下一步或 return 正确结果 - 是否对 reject/throw 做了合理处理(如 try/catch + yield)
用原生迭代器 + Jest 手动驱动测试
无需额外库,适合简单场景。以一个模拟 API 调用的 generator 为例:
function* loadUser(id) {
try {
const res = yield fetch(`/users/${id}`);
const user = yield res.json();
return { status: 'success', user };
} catch (err) {
return { status: 'error', message: err.message };
}
}测试写法:
test('loadUser yields fetch, then json, returns user on success', () => {
const gen = loadUser(123);
<p>// 第一次 yield:fetch 调用
expect(gen.next().value).toEqual(fetch('/users/123'));</p><p>// 模拟 fetch 返回 Response 对象(带 json 方法)
const mockResponse = {
json: jest.fn().mockResolvedValue({ id: 123, name: 'Alice' })
};</p><p>// 第二次 yield:res.json()
expect(gen.next(mockResponse).value).toEqual(mockResponse.json());</p><p>// 第三次:完成,返回结果
expect(gen.next({ id: 123, name: 'Alice' }).value).toEqual({
status: 'success',
user: { id: 123, name: 'Alice' }
});
});</p><p>test('loadUser handles fetch rejection', () => {
const gen = loadUser(123);
gen.next(); // 跳过 fetch</p><p>const error = new Error('Network failed');
const result = gen.throw(error);</p><p>expect(result.value).toEqual({
status: 'error',
message: 'Network failed'
});
});用 co + Jest 测试完整流程(仅限遗留项目)
若项目仍用 co 自动执行 generator,可这样测:
DMap GL地图JSAPI(dmapgl)开发指南。用于编写、审查、调试 DMap 地图 API 代码,涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
const co = require('co');
<p>test('co executes loadUser and resolves with user', async () => {
// mock fetch globally or use jest.mock('node-fetch')
global.fetch = jest.fn().mockResolvedValue({
json: () => Promise.resolve({ id: 456, name: 'Bob' })
});</p><p>const result = await co(loadUser, 456);
expect(result).toEqual({
status: 'success',
user: { id: 456, name: 'Bob' }
});
});⚠️ 注意:co 已停止维护,Node ≥ 8 后应优先用 async/await 重写 generator 逻辑,再直接测试 async 函数。
测试 redux-saga 时的 generator(常见真实场景)
如果你用的是 redux-saga,它的 take、call、put 都是纯对象(effect),测试更安全:
import { call, put } from 'redux-saga/effects';
import { fetchUserSuccess, fetchUserFailure } from './actions';
<p>function* fetchUserSaga(action) {
try {
const user = yield call(api.fetchUser, action.payload);
yield put(fetchUserSuccess(user));
} catch (err) {
yield put(fetchUserFailure(err.message));
}
}</p><p>// 测试 saga generator(不执行真实 API)
test('fetchUserSaga calls api and dispatches success', () => {
const gen = fetchUserSaga({ payload: 789 });</p><p>expect(gen.next().value).toEqual(call(api.fetchUser, 789));
expect(gen.next({ id: 789 }).value).toEqual(put(fetchUserSuccess({ id: 789 })));
});
这里用的是 redux-saga/test-utils 思路:只断言 yield 的 effect 对象,不触发真实副作用。
本质上,generator 异步测试的核心是“控制流断言”——你不是在测异步本身,而是在测它计划做什么、如何响应输入。现代实践倾向用 async/await 替代 generator,但理解 generator 测试逻辑,对维护老代码和深入理解 saga 等库非常有用。

















