Playwright Test- und Reporter-API

Dieser Anhang listet die Konfiguration, Fixture, Reporter und andere APIs des Playwright Test Runner auf.


Testfunktionen

MethodeBeschreibung
test(name, fn)Einen Test definieren
test.describe(name, fn)Eine Testgruppe definieren
test.describe.serial(name, fn)Serielle Testgruppe
test.describe.parallel(name, fn)Parallele Testgruppe
test.describe.configure(options)Gruppenverhalten konfigurieren (Modus, Wiederholungen)
test.skip(name?, fn?)Test überspringen
test.fail(name?, fn?)Als erwarteten Fehlschlag markieren
test.fixme(name?, fn?)Als fixme markieren (zu beheben)
test.slow(name?, fn?)Als langsamen Test markieren (Timeout × 3)
test.only(name, fn)Nur diesen Test ausführen
test.beforeEach(fn)Vor jedem Test ausführen
test.afterEach(fn)Nach jedem Test ausführen
test.beforeAll(fn)Einmal vor allen Tests ausführen
test.afterAll(fn)Einmal nach allen Tests ausführen
test.extend(fixtures)Benutzerdefinierte Fixture erstellen
test.use(options)Konfiguration für den aktuellen Scope überschreiben
test.setTimeout(ms)Timeout für den aktuellen Test festlegen
test.step(name, fn)Testschritte definieren (im Bericht sichtbar)
test.info()TestInfo-Objekt abrufen

TestConfig-Schnittstelle

FeldTypeBeschreibung
testDirstringTestverzeichnis
fullyParallelbooleschVollständig parallel
workersnumberAnzahl der Worker
retriesnumberAnzahl der Wiederholungsversuche
timeoutnumberGesamtes Test-Timeout
reporterstring | arrayReporter
forbidOnlybooleschVerbietenonly
testMatchstring | RegExpTestübereinstimmungsmuster
testIgnorestring | RegExpIgnoriermuster
projectsProject[]Projektliste
webServerObjektWebserver-Konfiguration
globalSetupstringPfad zum globalen Setup-Skript
globalTeardownstringPfad zum globalen Teardown-Skript
useObjektGemeinsame Konfiguration
expectObjektAssertion-Konfiguration

TestInfo-Schnittstelle

Feld/MethodeBeschreibung
testInfo.titleTestname
testInfo.fileTestdateipfad
testInfo.lineZeilennummer des Tests
testInfo.columnSpaltennummer des Tests
testInfo.expectedStatusErwarteter Status:'passed' | 'failed' | 'skipped'
testInfo.timeoutAktueller Test-Timeout
testInfo.annotationsAnnotationsliste
testInfo.attachmentsAnhangsliste
testInfo.project.nameAktueller Projektname
testInfo.retryAktuelle Wiederholungsanzahl
testInfo.parallelIndexParallel-Index
testInfo.skip(reason?)Test überspringen (dynamisch)
testInfo.fail(reason?)Als fehlgeschlagen markieren (dynamisch)
testInfo.attach(name, options?)Datei an Bericht anhängen

Fixtures-Schnittstelle

FixtureTypeBeschreibung
pagePageBrowser-Seite
contextBrowserContextBrowserkontext
browserBrowserBrowser-Instanz
browserNamestringBrowser-Name
requestAPIRequestContextHTTP-Anfrageclient

WorkerInfo-Schnittstelle

FeldBeschreibung
workerInfo.project.nameProjekt
workerInfo.parallelIndexParalleler Index des Workers
workerInfo.configFullConfig-Objekt

Reporter-Schnittstelle

MethodeBeschreibung
reporter.onBegin(config, suite)Start des Testlaufs
reporter.onTestBegin(test)Start eines einzelnen Tests
reporter.onTestEnd(test, result)Ende eines einzelnen Tests
reporter.onStepBegin(test, result, step)Start des Schritts
reporter.onStepEnd(test, result, step)Ende des Schritts
reporter.onEnd(result)Ende des Testlaufs
reporter.onExit()Prozessende
reporter.printsToStdio()Ob auf stdout ausgegeben werden soll

Suite-Klasse

FeldBeschreibung
suite.titleSuite-Name
suite.suitesListe untergeordneter Suiten
suite.testsTestliste
suite.locationSuite-Speicherort

TestCase-Klasse

FeldBeschreibung
test.titleTestname
test.locationTest-Speicherort
test.expectedStatusErwarteter Status
test.annotationsAnnotationsliste
test.parentÜbergeordnete Suite
test.id()Test-ID

TestResult-Klasse

FeldBeschreibung
result.statusStatus:'passed' | 'failed' | 'skipped' | 'interrupted'
result.durationDauer (Millisekunden)
result.errorFehlerinformationen (TestError)
result.attachmentsAnhangsliste
result.stdoutStandardausgabe
result.stderrStandardfehler

Electron-API

MethodeBeschreibung
electron.launch(options?)Electron-Anwendung starten

ElectronApplication-Klasse

MethodeBeschreibung
electronApp.firstWindow()Erstes Fenster abrufen
electronApp.windows()Alle Fenster abrufen
electronApp.close()Anwendung schließen

Android-API

Methode/KlasseBeschreibung
android.devices()Liste der verbundenen Geräte abrufen
AndroidDeviceAndroid-Geräteobjekt
AndroidWebViewWebView-Objekt
Weitere Erweiterungen