API Test et Reporter Playwright
Cette annexe répertorie la configuration, les Fixtures, les Reporters et les autres API du Playwright Test Runner.
Fonctions de test
| Méthode | Description |
test(name, fn) | Définir un test |
test.describe(name, fn) | Définir un groupe de tests |
test.describe.serial(name, fn) | Groupe de tests en série |
test.describe.parallel(name, fn) | Groupe de tests en parallèle |
test.describe.configure(options) | Configurer le comportement du groupe (mode, tentatives) |
test.skip(name?, fn?) | Ignorer un test |
test.fail(name?, fn?) | Marquer comme échec attendu |
test.fixme(name?, fn?) | Marquer comme fixme (à corriger) |
test.slow(name?, fn?) | Marquer comme test lent (timeout × 3) |
test.only(name, fn) | Exécuter uniquement ce test |
test.beforeEach(fn) | Exécuter avant chaque test |
test.afterEach(fn) | Exécuter après chaque test |
test.beforeAll(fn) | Exécuter une fois avant tous les tests |
test.afterAll(fn) | Exécuter une fois après tous les tests |
test.extend(fixtures) | Créer une fixture personnalisée |
test.use(options) | Remplacer la configuration pour la portée actuelle |
test.setTimeout(ms) | Définir le timeout pour le test actuel |
test.step(name, fn) | Définir les étapes de test (visibles dans le rapport) |
test.info() | Obtenir l'objet TestInfo |
Interface TestConfig
| Champ | Type | Description |
testDir | string | Répertoire de tests |
fullyParallel | booléen | Entièrement parallèle |
workers | nombre | Nombre de workers |
retries | nombre | Nombre de tentatives |
timeout | nombre | Délai d'expiration total des tests |
reporter | string | array | Rapporteur |
forbidOnly | booléen | Interdireonly |
testMatch | string | RegExp | Motif de correspondance des tests |
testIgnore | string | RegExp | Motif d'exclusion |
projects | Project[] | Liste des projets |
webServer | objet | Configuration du serveur Web |
globalSetup | string | Chemin du script de configuration globale |
globalTeardown | string | Chemin du script de démontage global |
use | objet | Configuration partagée |
expect | objet | Configuration des assertions |
Interface TestInfo
| Champ/Méthode | Description |
testInfo.title | Nom du test |
testInfo.file | Chemin du fichier de test |
testInfo.line | Numéro de ligne du test |
testInfo.column | Numéro de colonne du test |
testInfo.expectedStatus | Statut attendu :'passed' | 'failed' | 'skipped' |
testInfo.timeout | Délai d'attente actuel du test |
testInfo.annotations | Liste des annotations |
testInfo.attachments | Liste des pièces jointes |
testInfo.project.name | Nom du projet actuel |
testInfo.retry | Nombre de réessais actuel |
testInfo.parallelIndex | Index parallèle |
testInfo.skip(reason?) | Ignorer le test (dynamique) |
testInfo.fail(reason?) | Marquer comme échoué (dynamique) |
testInfo.attach(name, options?) | Joindre un fichier au rapport |
Interface des fixtures
| Fixture | Type | Description |
page | Page | Page du navigateur |
context | BrowserContext | Contexte de navigateur |
browser | Navigateur | Instance de navigateur |
browserName | string | Nom du navigateur |
request | APIRequestContext | Client de requête HTTP |
Interface WorkerInfo
| Champ | Description |
workerInfo.project.name | Nom du projet |
workerInfo.parallelIndex | Index parallèle du worker |
workerInfo.config | Objet FullConfig |
Interface Reporter
| Méthode | Description |
reporter.onBegin(config, suite) | Début de l'exécution des tests |
reporter.onTestBegin(test) | Début d'un test individuel |
reporter.onTestEnd(test, result) | Fin d'un test individuel |
reporter.onStepBegin(test, result, step) | Début de l'étape |
reporter.onStepEnd(test, result, step) | Fin de l'étape |
reporter.onEnd(result) | Fin de l'exécution des tests |
reporter.onExit() | Sortie du processus |
reporter.printsToStdio() | Indique s'il faut écrire sur stdout |
Classe Suite
| Champ | Description |
suite.title | Nom de la suite |
suite.suites | Liste des suites enfants |
suite.tests | Liste des tests |
suite.location | Emplacement de la suite |
Classe TestCase
| Champ | Description |
test.title | Nom du test |
test.location | Emplacement du test |
test.expectedStatus | Statut attendu |
test.annotations | Liste des annotations |
test.parent | Suite parente |
test.id() | ID du test |
Classe TestResult
| Champ | Description |
result.status | Statut :'passed' | 'failed' | 'skipped' | 'interrupted' |
result.duration | Durée (millisecondes) |
result.error | Informations sur l'erreur (TestError) |
result.attachments | Liste des pièces jointes |
result.stdout | Sortie standard |
result.stderr | Erreur standard |
Electron API
| Méthode | Description |
electron.launch(options?) | Lancer l'application Electron |
Classe ElectronApplication
| Méthode | Description |
electronApp.firstWindow() | Obtenir la première fenêtre |
electronApp.windows() | Obtenir toutes les fenêtres |
electronApp.close() | Fermer l'application |
Android API
| Méthode/Classe | Description |
android.devices() | Obtenir la liste des appareils connectés |
AndroidDevice | Objet appareil Android |
AndroidWebView | Objet WebView |
Autres extensions