如何在Playwright+TypeScript的参数化与非参数化测试间共享变量值

问题现象 #

1. 未使用参数化时，全局变量共享正常 #

未引入参数化时，全局变量可在不同测试用例间正常传递值：

import { ... } from '@playwright/test';

let myVariable: string;

// 配置测试串行执行
test.describe.configure({ mode: 'serial' })
test.beforeEach(async ({ page, variousPOJs }) => {
    // 访问主页等前置操作
    await page.goto('/');
});

test('场景1', async ({}) => {
    myVariable = "123";
});

test('场景2', async ({}) => {
    console.log(myVariable); // 输出 "123"
});

2. 引入参数化后，全局变量无法正常共享 #

加入参数化循环后，后续测试无法获取到参数化测试中赋值的变量值：

import { ... } from '@playwright/test';

let myVariable: string;

test.describe.configure({ mode: 'serial' })
test.beforeEach(async ({ page, variousPOJs }) => {
    // 访问主页等前置操作
    await page.goto('/');
});

const cases = [
    { nr: 1, title: "a", objName: "normal" },
    { nr: 2, title: "b", objName: "updated" }
];

for (const testCase of cases) {
  test(`测试用例${testCase.nr}: ${testCase.title}`, async ({}) => {
      // 错误：此处若误写为参数默认值会覆盖全局变量，需直接赋值全局变量
      myVariable = `some value ${testCase.objName}`;
  });
}

test('测试用例3: c', async ({}) => {
    console.log(myVariable); // 输出 undefined
});

简化解决方案（单文件实现） #

无需额外创建共享状态模块，仅需修正参数化测试的变量赋值逻辑，并确保测试串行执行即可：

import { test, expect } from '@playwright/test';

// 声明全局共享变量，用于存储对象名称
let objectName: string;

// 配置测试串行执行，保证变量按执行顺序传递
test.describe.configure({ mode: 'serial' });

test.beforeEach(async ({ page }) => {
    // 仅执行访问主页等前置操作，不要重置共享变量
    await page.goto('/');
});

// 参数化测试：创建对象并保存名称
const testCases = [
    { nr: 1, action: "创建普通对象", objType: "normal" },
    { nr: 2, action: "创建更新对象", objType: "updated" }
];

for (const tc of testCases) {
  test(`测试用例${tc.nr}: ${tc.action}`, async ({ page }) => {
    // 模拟创建对象的实际操作（替换为你的业务步骤）
    await page.click('#create-object-btn');
    await page.fill('#object-type', tc.objType);
    await page.click('#submit-create');

    // 获取创建后的对象名称并赋值给全局变量
    objectName = await page.textContent('#object-name');
    console.log(`当前对象名称：${objectName}`);
  });
}

// 后续测试：使用共享的对象名称执行更新操作
test('测试用例3: 更新对象名称', async ({ page }) => {
    if (!objectName) {
        throw new Error('未获取到对象名称，请检查前置测试是否执行成功');
    }

    // 使用共享的对象名称查找目标对象
    await page.fill('#search-object', objectName);
    await page.click('#search-btn');

    // 执行更新操作
    await page.click('#edit-object-btn');
    await page.fill('#new-object-name', `${objectName}_updated`);
    await page.click('#submit-update');

    // 验证更新结果
    const updatedName = await page.textContent('#object-name');
    expect(updatedName).toBe(`${objectName}_updated`);
});

关键注意点 #

• 保持串行执行：必须通过test.describe.configure({ mode: 'serial' })配置测试串行运行，否则并行执行会导致变量值被覆盖或读取异常。
• 正确赋值全局变量：参数化测试中直接对全局变量赋值，不要在测试函数的参数中声明同名变量（避免局部变量覆盖全局变量）。
• 不要在beforeEach中重置共享变量：若需保留前置测试的变量值，不要在beforeEach中清空共享变量，仅执行页面初始化等无关操作。

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