Exécution des tests Playwright
Ce chapitre présente de manière exhaustive comment exécuter les tests Playwright, les arguments de ligne de commande et diverses techniques de filtrage.
Commandes d'exécution de base
Exemples
# Exécuter tous les tests
npx playwright test
# Par défaut, utilise le projet configuré dans package.json
npm test
npx playwright test
# Par défaut, utilise le projet configuré dans package.json
npm test
Filtrage de tests spécifiques
Par chemin de fichier
# 运行单个测试文件 npx playwright test tests/login.spec.ts # 运行目录中的所有测试 npx playwright test tests/user/ # 运行多个文件(空格分隔) npx playwright test tests/login.spec.ts tests/register.spec.ts
Par mot-clé du nom de fichier
# 运行文件名中包含 "login" 或 "user" 的所有测试 npx playwright test login user
Filtrer par nom de test (-g / --grep)
# 运行测试名称中包含 "登录" 的测试 npx playwright test -g "登录" # 通过正则表达式筛选 npx playwright test -g "登录|注册"
Filtrer par tag
Exemples
// Définir un tag dans le test
test('Test de smoke rapide @smoke', async ({ page }) => {
// ...
});
test('Test lent @slow', async ({ page }) => {
// ...
});
test('Test de smoke rapide @smoke', async ({ page }) => {
// ...
});
test('Test lent @slow', async ({ page }) => {
// ...
});
# 只运行带 @smoke 标签的测试 npx playwright test --grep "@smoke" # 跳过带 @slow 标签的测试 npx playwright test --grep-invert "@slow"
Contrôle du navigateur
Spécifier le navigateur (--project)
# 只在 Chromium 上运行 npx playwright test --project=chromium # 在多个浏览器上运行 npx playwright test --project=chromium --project=firefox
Mode avec interface graphique (--headed)
# 显示浏览器窗口(默认无头) npx playwright test --headed
Spécifier le chemin de l'exécutable du navigateur
# 使用本地安装的 Chrome 而非 Playwright 的 Chromium npx playwright test --project=chromium \ --channel=chrome
Modes d'exécution
Mode UI (--ui)
# 在 UI 模式下运行(推荐开发和调试时使用) npx playwright test --ui
Mode débogage (--debug)
# 单步调试测试 npx playwright test --debug
Parallélisme et répétition
Contrôler le nombre de workers (--workers)
# 使用 4 个 worker 并行运行 npx playwright test --workers=4 # 单线程运行(方便调试) npx playwright test --workers=1
Répéter l'exécution (--repeat-each)
# 每个测试重复运行 3 次(检查稳定性) npx playwright test --repeat-each=3
Exécution fragmentée (--shard)
# 在 CI 上分片运行(分 4 片,当前为第 1 片) npx playwright test --shard=1/4 # 第 2 片 npx playwright test --shard=2/4
Le sharding est couramment utilisé en CI pour exécuter des tests en parallèle sur plusieurs machines, chaque machine n'exécutant qu'une partie, puis en fusionnant les résultats.
Captures d'écran et contrôle des traces
# 更新视觉回归的基准截图 npx playwright test --update-snapshots # 强制生成 Trace 文件(即使配置中没有开启) npx playwright test --trace on # 查看最后一次运行的 Trace npx playwright show-trace test-results/.../trace.zip
Référence rapide des commandes courantes
| Commande | Description |
|---|---|
npx playwright test | Exécuter tous les tests |
npx playwright test file.spec.ts | Exécuter le fichier spécifié |
npx playwright test -g "关键词" | Filtrer par nom de test |
npx playwright test --project=chromium | Spécifier le navigateur |
npx playwright test --headed | Mode avec interface graphique (afficher la fenêtre du navigateur) |
npx playwright test --ui | Mode UI |
npx playwright test --debug | Mode débogage |
npx playwright test --workers=4 | Spécifier le nombre de workers |
npx playwright test --shard=1/4 | Exécution en shards |
npx playwright test --repeat-each=3 | Répéter l'exécution |
npx playwright test --update-snapshots | Mettre à jour les captures d'écran de référence visuelle |
npx playwright show-report | Afficher le rapport HTML |
npx playwright show-trace trace.zip | Afficher la trace |
npx playwright codegen url | Lancer le générateur de code |