Jest 无法直接运行 Web Worker，需通过抽离纯函数、mock Worker 类或切换至浏览器环境（如 Vitest/@web/test-runner）进行测试，并需显式处理 Worker 错误。
Jest 本身不支持直接运行 Web Worker，因为它是基于 Node.js 环境的测试框架，而 Web Worker 依赖浏览器的 Worker 构造函数和 DOM API。但你可以通过模拟（mock）、隔离逻辑、或使用兼容环境来有效测试 Worker 行为——核心思路是：**把可测试的逻辑抽离出来，让 Worker 只负责通信和调度**。
把 Worker 内部逻辑拆成纯函数
Worker 脚本通常包含两部分：监听 onmessage 和执行具体任务。不要在 self.onmessage 回调里写复杂逻辑，而是把它封装成独立函数，导出供 Jest 测试。
例如，你的 sum.worker.js 可以这样组织：
// sum.worker.js
import { calculateSum } from './math-utils.js';
self.onmessage = function (e) {
const result = calculateSum(e.data.a, e.data.b);
self.postMessage({ result });
};
然后在 math-utils.js 中导出纯函数：
// math-utils.js
export function calculateSum(a, b) {
return a + b;
}
这样你就能在 Jest 中直接 import 并测试 calculateSum，无需启动 Worker。
用 mock 实现 Worker 的端到端通信测试
如果必须验证整个 Worker 的消息收发流程（比如多线程协作逻辑），可以在 Jest 中 mock Worker 构造函数，并手动触发 onmessage 模拟响应。
在测试文件中：
// sum.worker.test.js
jest.mock('./sum.worker.js', () => ({
__esModule: true,
default: jest.fn(),
}));
// 手动模拟 Worker 类
class MockWorker {
constructor(url) {
this.url = url;
this.onmessage = null;
}
postMessage(data) {
// 模拟 Worker 收到消息后，自己调用 onmessage（即“回复”）
if (this.onmessage) {
// 这里可以引入真实 worker 逻辑，或直接返回固定结果
this.onmessage({ data: { result: data.a + data.b } });
}
}
}
global.Worker = MockWorker;
test('Worker returns correct sum', (done) => {
const worker = new Worker('./sum.worker.js');
worker.onmessage = (e) => {
expect(e.data.result).toBe(7);
done();
};
worker.postMessage({ a: 3, b: 4 });
});
注意：这种 mock 不执行真实 Worker 代码，只是验证通信契约是否符合预期。适合集成层面的轻量测试。
用 jsdom + worker-loader（Webpack）或 @web/test-runner 配合真实 Worker
若需运行真实 Worker 代码（如涉及 fetch、SharedArrayBuffer 或复杂计算），推荐切换到支持浏览器环境的测试工具链：
-
jsdom + Jest + worker-loader：需配置 Webpack（或使用
jest-webpack插件），让 Jest 加载 Worker 文件为模块； -
@web/test-runner（推荐）：原生支持浏览器上下文，可直接
new Worker('./xxx.worker.js')，并运行在真实 Chromium 中； -
Vitest：配合
mode: 'browser'和worker: true配置，也能加载并执行 Worker。
例如 Vitest 配置片段：
// vitest.config.ts
export default defineConfig({
test: {
environment: 'happy-dom', // 或 'node' + 自定义 setup
// 若需真实 Worker，改用 browser 环境并启用 worker 支持
}
});
测试 Worker 错误处理和异常边界
Worker 中未捕获的异常不会冒泡到主线程，容易静默失败。建议显式监听 onerror 并转发，同时在测试中覆盖错误路径。
在 Worker 脚本中：
self.onerror = function (e) {
self.postMessage({ error: e.message });
};
对应测试：
test('Worker reports error on invalid input', (done) => {
const worker = new MockWorker();
worker.onmessage = (e) => {
expect(e.data.error).toContain('NaN');
done();
};
// 触发一个会报错的计算（如传入非数字）
worker.postMessage({ a: 'x', b: 5 });
});
