如何在Playwright中参数化测试，适配多环境执行指定用例？

针对你的场景，方案2（环境变量控制测试范围）确实是更优选择，无需维护多分支，以下是具体实现步骤：

一、Azure DevOps 流水线配置 #

1. 添加环境专属变量
   在Dev、TST、UAT三个环境的流水线变量组（或流水线级变量）中，新增TEST_MODULES变量：

   • Dev/TST环境：值设为module1,module2
   • UAT环境：值设为module1

2. 修改Playwright执行命令
   在流水线的测试任务中，将原执行命令替换为带环境变量的版本，两种方式可选：

   方式A：基于标签过滤（灵活度高） #

   利用Playwright的--grep参数匹配测试用例标签，Azure DevOps中可通过命令拼接正则：

   # 把逗号分隔的模块名转成正则匹配格式，比如module1,module2 → @module1|@module2
   MODULE_GREP=$(echo "$(TEST_MODULES)" | sed 's/,/\\|@/g')
   npx playwright test --grep "@$MODULE_GREP"
   

   方式B：基于项目配置（结构清晰） #

   如果测试用例已按模块分目录存放，可通过Playwright的project配置指定执行范围：

   npx playwright test --project=$(TEST_MODULES)
   

二、Playwright 代码层改造 #

对应方式A：给测试用例打标签 #

在模块1、模块2的测试用例（或describe块）上添加专属标签：

// 模块1测试用例示例
test.describe('模块1 - 用户登录流程 @module1', () => {
  test('验证用户名密码登录', async ({ page }) => {
    // 测试逻辑
  });
});

// 模块2测试用例示例
test.describe('模块2 - 数据导出功能 @module2', () => {
  test('导出Excel格式数据', async ({ page }) => {
    // 测试逻辑
  });
});

对应方式B：配置Playwright项目 #

在playwright.config.ts中定义对应模块的project：

import { defineConfig, devices } from '@playwright/test';

export default defineConfig({
  projects: [
    {
      name: 'module1',
      testMatch: '**/tests/module1/**/*.spec.ts', // 模块1的测试文件路径
      use: { ...devices['Desktop Chrome'] },
    },
    {
      name: 'module2',
      testMatch: '**/tests/module2/**/*.spec.ts', // 模块2的测试文件路径
      use: { ...devices['Desktop Chrome'] },
    },
  ],
});

三、可选：全局跳过逻辑（更严谨） #

如果担心标签或project配置遗漏，可在全局测试前置逻辑中添加过滤，确保不符合环境的用例直接跳过：

// test.setup.ts
import { test as base } from '@playwright/test';

// 读取环境变量，默认只执行module1
const allowedModules = process.env.TEST_MODULES?.split(',') || ['module1'];

export const test = base.extend({});

// 每个测试用例执行前判断是否允许运行
test.beforeEach(async ({}, testInfo) => {
  // 从测试用例标题/标签中提取所属模块
  const moduleTag = testInfo.title.match(/@module(\d)/)?.[1];
  if (moduleTag && !allowedModules.includes(`module${moduleTag}`)) {
    test.skip();
  }
});

四、验证方案 #

• 触发Dev/TST流水线：确认模块1、模块2的用例都执行
• 触发UAT流水线：确认仅模块1的用例执行，模块2的用例被跳过或未被选中

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