如何结合Jest与puppeteer-cluster实现端到端测试并行执行

你当前遇到的两个异常现象，本质来自三个层面的实现错误：

• 断言全部无理由通过：cluster.queue() 是非阻塞入队操作，调用后会立刻返回，不会等待队列内的任务执行完成。你写在it块里的逻辑仅完成任务入队就结束，Jest会直接判定用例执行成功；同时任务内部的断言错误发生在puppeteer-cluster的独立执行上下文里，根本不会冒泡到Jest的测试回调，哪怕断言真的不匹配，Jest也完全感知不到。
• 看不到多浏览器实例：第一，你配置的CONCURRENCY_CONTEXT模式仅会启动单个浏览器进程，通过多开隐身上下文实现资源隔离，不会生成多个独立浏览器窗口；第二，初始化Cluster时完全没有传入jest-puppeteer中配置的浏览器启动参数，Cluster会用默认配置启动浏览器，缺失你要求的硬件加速参数、窗口尺寸参数，和预期运行环境完全不匹配。
• 测试无法真正并行：默认Jest是单进程串行执行测试用例的，哪怕Cluster内部开了多上下文，Jest层面的调度逻辑没有做并行配置，实际执行还是串行的。

核心配置调整 #

• 并发模式选择：如果需要独立的浏览器进程隔离、满足硬件加速的GPU资源独立分配要求，要把并发模式换成CONCURRENCY_BROWSER，这个模式会按照maxConcurrency参数启动独立的浏览器实例，每个实例有独立的GPU上下文，可直接观察到多个独立浏览器窗口。
• 参数复用：将jest-puppeteer中定义的所有启动参数，完整同步到Cluster的puppeteerOptions配置中，保留headless: false的要求，避免重复维护两套启动参数出现配置不一致的问题。
• 执行方式替换：用*cluster.execute()*替代cluster.queue()，这个方法会返回任务执行的完整Promise，直到任务执行结束、所有错误被捕获后才返回，确保Jest能正确等待任务完成、接收失败信号。

修正后的参考代码 #

import { Page } from 'puppeteer';
import { Cluster } from 'puppeteer-cluster';
// 复用现有jest-puppeteer配置，避免配置重复
import jestPuppeteerConfig from './jest-puppeteer.config';

let cluster: Cluster;

describe('Pools', () => {
    beforeAll(async () => {
        cluster = await Cluster.launch({
            // 独立浏览器实例模式，满足多窗口、硬件加速隔离要求
            concurrency: Cluster.CONCURRENCY_BROWSER,
            maxConcurrency: 3,
            // 完全复用jest-puppeteer的启动参数，包括headless:false、窗口尺寸、硬件加速规则
            puppeteerOptions: {
                ...jestPuppeteerConfig.launch,
            }
        });
    });

    const task1 = async (page: Page) => {
        await page.goto('http://www.wikipedia.org');
        const pageTitle = await page.evaluate(() => document.title);
        // 直接在任务内做断言判断，抛出标准Error，避免全局expect的上下文丢失问题
        if (!pageTitle.match('asdasdasdasdasdadasdasdasdasdadafasfasdasdasdasdasdasdassdadasdadas')) {
            throw new Error(`断言失败，实际页面标题: ${pageTitle}`);
        }
        return pageTitle;
    };

    describe('Testing', () => {
        it('test1', async () => {
            // 用execute等待任务执行完成，透传所有错误给Jest
            await cluster.execute(null, task1);
        });
        it('test2', async () => {
            await cluster.execute(null, task1);
        });
        it('test3', async () => {
            await cluster.execute(null, task1);
        });
        it('test4', async () => {
            await cluster.execute(null, task1);
        });
    });

    afterAll(async () => {
        // 等待所有任务执行完成，关闭集群，避免测试进程挂起
        await cluster.idle();
        await cluster.close();
    });
});

• 不要在Cluster任务内直接调用Jest的全局expect方法：这类全局方法依赖Jest的运行时上下文，在puppeteer-cluster的独立异步任务中执行时，Jest的超时、失败统计逻辑无法正确关联到任务，容易出现错误被忽略的问题，建议在任务内做条件判断抛出标准Error，通过execute的Promise透传错误。
• maxConcurrency参数不要设置过高：由于要求关闭headless模式，每个浏览器实例会占用独立的GPU、内存资源，一般设置为2-3个并发就可以将20分钟的串行测试耗时压缩到7分钟以内，设置过高反而会因为资源争抢拖慢整体执行速度。
• 配合Jest的文件级并行机制：如果测试规模后续继续增长，可以将单个测试文件拆分为独立的测试文件，给Jest配置--maxWorkers参数匹配机器CPU核数，让Jest的worker机制做文件层面的并行调度，每个worker内部启动独立的Cluster实例，避免跨文件的资源竞争。
• 保持headless: false配置不变：不要为了压缩耗时切换为headless模式，否则会丢失硬件加速能力，不符合测试场景要求。

内容的提问来源于stack exchange，提问作者ka_lin