自动化测试 / 系统课时
配置多浏览器项目
配置多浏览器项目
Playwright Test 的 project 可以让同一套测试在不同浏览器、设备或运行参数下重复执行。本课将 Chromium、Firefox、WebKit 和移动设备配置成独立项目,并验证如何一次跑全量或只运行指定项目。
学习目标
- 理解 project 如何把同一测试映射到不同运行环境
- 配置 Chromium、Firefox、WebKit 与移动设备预设
- 使用
--project精确选择运行目标并验证配置
Project 是一组运行参数
projects 是 playwright.config.ts 中的顶层配置。每个项目都有独立名称,并可通过 use 指定浏览器、设备、视口、语言或其他上下文参数。运行测试时,同一个测试文件会按匹配到的项目分别执行,因此项目名应表达清楚测试环境。
如果只需要桌面三大浏览器,可以直接指定 browserName;需要设备模拟时,使用 Playwright 提供的 devices 预设更省事,因为它会同时带入视口、User-Agent、触摸能力等相关参数。
配置桌面浏览器与移动设备
下面的配置建立四个项目:三个桌面浏览器引擎,以及一个基于 WebKit 的 iPhone 设备预设。设备预设放在 use 中展开,项目之间互不覆盖。
import { defineConfig, devices } from '@playwright/test';
export default defineConfig({
testDir: './tests',
projects: [
{
name: 'chromium',
use: { browserName: 'chromium' },
},
{
name: 'firefox',
use: { browserName: 'firefox' },
},
{
name: 'webkit',
use: { browserName: 'webkit' },
},
{
name: 'mobile-safari',
// 设备预设会带入移动视口、User-Agent 与触摸能力等参数。
use: { ...devices['iPhone 13'] },
},
],
});配置文件本身不会产生控制台结果。验证方法是运行测试并检查报告中的项目名;若本机尚未安装对应浏览器,可先执行 npx playwright install chromium firefox webkit。
用一个测试验证四个项目
测试可以读取 testInfo.project.name 与 browserName,这样无需依赖外部网站,就能确认当前项目实际使用的浏览器引擎。
import { expect, test } from '@playwright/test';
test('项目参数生效', async ({ page, browserName }, testInfo) => {
// setContent 让示例不依赖公网服务,专注验证项目配置。
await page.setContent('<h1>Playwright Projects</h1>');
console.log(`${testInfo.project.name} -> ${browserName}`);
await expect(page.getByRole('heading')).toHaveText('Playwright Projects');
});运行全部项目:
npx playwright test --reporter=line预期输出包含四个项目各一次通过;实际打印顺序和耗时可能不同:
chromium -> chromium
firefox -> firefox
webkit -> webkit
mobile-safari -> webkit
4 passed (<TIME>)这里 mobile-safari 使用 WebKit 引擎,所以 browserName 仍是 webkit;项目名描述的是你定义的测试环境,不等于浏览器引擎字段。
只运行需要的项目
开发阶段通常不必每次跑完整矩阵。使用 --project 可以只选择一个项目,例如:
npx playwright test --project=webkit --reporter=line预期结果:
webkit -> webkit
1 passed (<TIME>)也可以多次传入 --project 或按项目名模式筛选。CI 中常见做法是把浏览器项目拆成不同任务并行运行,但仍共享同一份测试代码;这样既保留跨浏览器覆盖,又能让失败明确归属到具体项目。
避免把 Project 当成复制测试
Project 的价值是复用同一测试逻辑,而不是为每个浏览器复制一份 spec 文件。如果某个浏览器确实需要差异化处理,应先判断这是产品差异、能力限制还是测试设计问题,再用项目级 use、条件跳过或专门 fixture 处理。
多浏览器配置完成后,最关键的验收标准不是“项目数量很多”,而是每个项目名称清楚、运行参数可追踪,并且同一条核心测试能在目标浏览器或设备环境中独立通过。