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éthodeDescription
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

ChampTypeDescription
testDirstringRépertoire de tests
fullyParallelbooléenEntièrement parallèle
workersnombreNombre de workers
retriesnombreNombre de tentatives
timeoutnombreDélai d'expiration total des tests
reporterstring | arrayRapporteur
forbidOnlybooléenInterdireonly
testMatchstring | RegExpMotif de correspondance des tests
testIgnorestring | RegExpMotif d'exclusion
projectsProject[]Liste des projets
webServerobjetConfiguration du serveur Web
globalSetupstringChemin du script de configuration globale
globalTeardownstringChemin du script de démontage global
useobjetConfiguration partagée
expectobjetConfiguration des assertions

Interface TestInfo

Champ/MéthodeDescription
testInfo.titleNom du test
testInfo.fileChemin du fichier de test
testInfo.lineNuméro de ligne du test
testInfo.columnNuméro de colonne du test
testInfo.expectedStatusStatut attendu :'passed' | 'failed' | 'skipped'
testInfo.timeoutDélai d'attente actuel du test
testInfo.annotationsListe des annotations
testInfo.attachmentsListe des pièces jointes
testInfo.project.nameNom du projet actuel
testInfo.retryNombre de réessais actuel
testInfo.parallelIndexIndex 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

FixtureTypeDescription
pagePagePage du navigateur
contextBrowserContextContexte de navigateur
browserNavigateurInstance de navigateur
browserNamestringNom du navigateur
requestAPIRequestContextClient de requête HTTP

Interface WorkerInfo

ChampDescription
workerInfo.project.nameNom du projet
workerInfo.parallelIndexIndex parallèle du worker
workerInfo.configObjet FullConfig

Interface Reporter

MéthodeDescription
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

ChampDescription
suite.titleNom de la suite
suite.suitesListe des suites enfants
suite.testsListe des tests
suite.locationEmplacement de la suite

Classe TestCase

ChampDescription
test.titleNom du test
test.locationEmplacement du test
test.expectedStatusStatut attendu
test.annotationsListe des annotations
test.parentSuite parente
test.id()ID du test

Classe TestResult

ChampDescription
result.statusStatut :'passed' | 'failed' | 'skipped' | 'interrupted'
result.durationDurée (millisecondes)
result.errorInformations sur l'erreur (TestError)
result.attachmentsListe des pièces jointes
result.stdoutSortie standard
result.stderrErreur standard

Electron API

MéthodeDescription
electron.launch(options?)Lancer l'application Electron

Classe ElectronApplication

MéthodeDescription
electronApp.firstWindow()Obtenir la première fenêtre
electronApp.windows()Obtenir toutes les fenêtres
electronApp.close()Fermer l'application

Android API

Méthode/ClasseDescription
android.devices()Obtenir la liste des appareils connectés
AndroidDeviceObjet appareil Android
AndroidWebViewObjet WebView
Autres extensions