Playwright 运行测试
本章全面介绍 Playwright 测试的运行方式、命令行参数以及各种筛选技巧。
基本运行命令
实例
bash
# 运行所有测试
npx playwright test
# 默认使用 package.json 中配置的项目
npm test筛选特定测试
按文件路径
bash
# 运行单个测试文件
npx playwright test tests/login.spec.ts
# 运行目录中的所有测试
npx playwright test tests/user/
# 运行多个文件（空格分隔）
npx playwright test tests/login.spec.ts tests/register.spec.ts按文件名关键词
bash
# 运行文件名中包含 "login" 或 "user" 的所有测试
npx playwright test login user按测试名称筛选（-g / --grep）
bash
# 运行测试名称中包含 "登录" 的测试
npx playwright test -g "登录"
# 通过正则表达式筛选
npx playwright test -g "登录|注册"按 Tag 筛选
实例
javascript
// 在测试中定义 tag
test('快速冒烟测试 @smoke', async ({ page }) => {
// ...
});
test('慢速测试 @slow', async ({ page }) => {
// ...
});bash
# 只运行带 @smoke 标签的测试
npx playwright test --grep "@smoke"
# 跳过带 @slow 标签的测试
npx playwright test --grep-invert "@slow"浏览器控制
指定浏览器（--project）
bash
# 只在 Chromium 上运行
npx playwright test --project=chromium
# 在多个浏览器上运行
npx playwright test --project=chromium --project=firefox有头模式（--headed）
bash
# 显示浏览器窗口（默认无头）
npx playwright test --headed指定浏览器可执行路径
bash
# 使用本地安装的 Chrome 而非 Playwright 的 Chromium
npx playwright test --project=chromium \
--channel=chrome执行模式
UI 模式（--ui）
bash
# 在 UI 模式下运行（推荐开发和调试时使用）
npx playwright test --ui调试模式（--debug）
bash
# 单步调试测试
npx playwright test --debug并行与重复
控制并行数（--workers）
bash
# 使用 4 个 worker 并行运行
npx playwright test --workers=4
# 单线程运行（方便调试）
npx playwright test --workers=1重复运行（--repeat-each）
bash
# 每个测试重复运行 3 次（检查稳定性）
npx playwright test --repeat-each=3分片运行（--shard）
bash
# 在 CI 上分片运行（分 4 片，当前为第 1 片）
npx playwright test --shard=1/4
# 第 2 片
npx playwright test --shard=2/4分片常用于 CI 中多台机器并行运行测试，每台机器只跑一部分，最终合并结果。
截图与 Trace 控制
bash
# 更新视觉回归的基准截图
npx playwright test --update-snapshots
# 强制生成 Trace 文件（即使配置中没有开启）
npx playwright test --trace on
# 查看最后一次运行的 Trace
npx playwright show-trace test-results/.../trace.zip常用命令速查
| 命令 | 作用 |
|---|---|
npx playwright test | 运行所有测试 |
npx playwright test file.spec.ts | 运行指定文件 |
npx playwright test -g "关键词" | 按测试名称筛选 |
npx playwright test --project=chromium | 指定浏览器 |
npx playwright test --headed | 有头模式（显示浏览器窗口） |
npx playwright test --ui | UI 模式 |
npx playwright test --debug | 调试模式 |
npx playwright test --workers=4 | 指定 worker 数量 |
npx playwright test --shard=1/4 | 分片运行 |
npx playwright test --repeat-each=3 | 重复运行 |
npx playwright test --update-snapshots | 更新视觉基准截图 |
npx playwright show-report | 查看 HTML 报告 |
npx playwright show-trace trace.zip | 查看 Trace |
npx playwright codegen url | 启动代码生成器 |
AI 思考中...