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

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 }) => {
  // ...
});
# 只运行带 @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

CommandeDescription
npx playwright testExécuter tous les tests
npx playwright test file.spec.tsExécuter le fichier spécifié
npx playwright test -g "关键词"Filtrer par nom de test
npx playwright test --project=chromiumSpécifier le navigateur
npx playwright test --headedMode avec interface graphique (afficher la fenêtre du navigateur)
npx playwright test --uiMode UI
npx playwright test --debugMode débogage
npx playwright test --workers=4Spécifier le nombre de workers
npx playwright test --shard=1/4Exécution en shards
npx playwright test --repeat-each=3Répéter l'exécution
npx playwright test --update-snapshotsMettre à jour les captures d'écran de référence visuelle
npx playwright show-reportAfficher le rapport HTML
npx playwright show-trace trace.zipAfficher la trace
npx playwright codegen urlLancer le générateur de code
Autres extensions