自动化测试 / 系统课时

配置多浏览器项目

配置多浏览器项目

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 中展开,项目之间互不覆盖。

ts
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,这样无需依赖外部网站,就能确认当前项目实际使用的浏览器引擎。

ts
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');
});

运行全部项目:

bash
npx playwright test --reporter=line

预期输出包含四个项目各一次通过;实际打印顺序和耗时可能不同:

text
chromium -> chromium
firefox -> firefox
webkit -> webkit
mobile-safari -> webkit
4 passed (<TIME>)

这里 mobile-safari 使用 WebKit 引擎,所以 browserName 仍是 webkit;项目名描述的是你定义的测试环境,不等于浏览器引擎字段。

只运行需要的项目

开发阶段通常不必每次跑完整矩阵。使用 --project 可以只选择一个项目,例如:

bash
npx playwright test --project=webkit --reporter=line

预期结果:

text
webkit -> webkit
1 passed (<TIME>)

也可以多次传入 --project 或按项目名模式筛选。CI 中常见做法是把浏览器项目拆成不同任务并行运行,但仍共享同一份测试代码;这样既保留跨浏览器覆盖,又能让失败明确归属到具体项目。

避免把 Project 当成复制测试

Project 的价值是复用同一测试逻辑,而不是为每个浏览器复制一份 spec 文件。如果某个浏览器确实需要差异化处理,应先判断这是产品差异、能力限制还是测试设计问题,再用项目级 use、条件跳过或专门 fixture 处理。

多浏览器配置完成后,最关键的验收标准不是“项目数量很多”,而是每个项目名称清楚、运行参数可追踪,并且同一条核心测试能在目标浏览器或设备环境中独立通过。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

配置多浏览器项目

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通