Playwright中如何实现测试套件并行但套件内测试串行执行

架构老林

2026-9-25

解决方案

Playwright原生支持你需要的执行逻辑，无需调整现有实现思路，按以下两步配置即可：

第一步：开启单文件内测试套件并行能力
在playwright.config.ts配置文件中添加fullyParallel: true配置，该配置会允许单个测试文件内的多个独立测试套件并行执行，刚好匹配你不同catalog测试套件无依赖、可并行的要求。
第二步：指定单个测试套件内用例串行执行
在你动态生成的每个test.describe回调内部的开头位置，添加test.describe.configure({ mode: 'serial' })配置，即可强制当前套件下的所有测试用例按顺序串行执行，完全适配你复用Page实例、利用客户端缓存提升执行效率的需求。

修改后的代码示例

catalogs.forEach((objectIdsOfCatalog, catalogId) => {
    test.describe('Test catalog "' + catalogId + '"', () => {
        // 新增这一行即可实现套件内用例串行
        test.describe.configure({ mode: 'serial' });

        let newVersion: PageObject;
        let actualVersion: PageObject;

        test.beforeAll(async ({browser}) => {
            console.log('New page for', catalogId);
            const {actualUrl, newUrl} = getConfig();
            const context = await browser.newContext();
            actualVersion = new PageObject(await context.newPage(), actualUrl);
            newVersion = new PageObject(await context.newPage(), newUrl);
        });

        test.afterAll(async () => {
            console.log('Close page for', catalogId);
            actualVersion.close();
            newVersion.close();
            actualVersion = null;
            newVersion = null;
        });

        for (const objectId of objectIdsOfCatalog) {
            test('Testing "' + objectId + '"', async () => {
                // 测试逻辑
            });
        }
    });
});