Playwright Test- und Reporter-API
Dieser Anhang listet die Konfiguration, Fixture, Reporter und andere APIs des Playwright Test Runner auf.
Testfunktionen
| Methode | Beschreibung |
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
| Feld | Type | Beschreibung |
testDir | string | Testverzeichnis |
fullyParallel | boolesch | Vollständig parallel |
workers | number | Anzahl der Worker |
retries | number | Anzahl der Wiederholungsversuche |
timeout | number | Gesamtes Test-Timeout |
reporter | string | array | Reporter |
forbidOnly | boolesch | Verbietenonly |
testMatch | string | RegExp | Testübereinstimmungsmuster |
testIgnore | string | RegExp | Ignoriermuster |
projects | Project[] | Projektliste |
webServer | Objekt | Webserver-Konfiguration |
globalSetup | string | Pfad zum globalen Setup-Skript |
globalTeardown | string | Pfad zum globalen Teardown-Skript |
use | Objekt | Gemeinsame Konfiguration |
expect | Objekt | Assertion-Konfiguration |
TestInfo-Schnittstelle
| Feld/Methode | Beschreibung |
testInfo.title | Testname |
testInfo.file | Testdateipfad |
testInfo.line | Zeilennummer des Tests |
testInfo.column | Spaltennummer des Tests |
testInfo.expectedStatus | Erwarteter Status:'passed' | 'failed' | 'skipped' |
testInfo.timeout | Aktueller Test-Timeout |
testInfo.annotations | Annotationsliste |
testInfo.attachments | Anhangsliste |
testInfo.project.name | Aktueller Projektname |
testInfo.retry | Aktuelle Wiederholungsanzahl |
testInfo.parallelIndex | Parallel-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
| Fixture | Type | Beschreibung |
page | Page | Browser-Seite |
context | BrowserContext | Browserkontext |
browser | Browser | Browser-Instanz |
browserName | string | Browser-Name |
request | APIRequestContext | HTTP-Anfrageclient |
WorkerInfo-Schnittstelle
| Feld | Beschreibung |
workerInfo.project.name | Projekt |
workerInfo.parallelIndex | Paralleler Index des Workers |
workerInfo.config | FullConfig-Objekt |
Reporter-Schnittstelle
| Methode | Beschreibung |
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
| Feld | Beschreibung |
suite.title | Suite-Name |
suite.suites | Liste untergeordneter Suiten |
suite.tests | Testliste |
suite.location | Suite-Speicherort |
TestCase-Klasse
| Feld | Beschreibung |
test.title | Testname |
test.location | Test-Speicherort |
test.expectedStatus | Erwarteter Status |
test.annotations | Annotationsliste |
test.parent | Übergeordnete Suite |
test.id() | Test-ID |
TestResult-Klasse
| Feld | Beschreibung |
result.status | Status:'passed' | 'failed' | 'skipped' | 'interrupted' |
result.duration | Dauer (Millisekunden) |
result.error | Fehlerinformationen (TestError) |
result.attachments | Anhangsliste |
result.stdout | Standardausgabe |
result.stderr | Standardfehler |
Electron-API
| Methode | Beschreibung |
electron.launch(options?) | Electron-Anwendung starten |
ElectronApplication-Klasse
| Methode | Beschreibung |
electronApp.firstWindow() | Erstes Fenster abrufen |
electronApp.windows() | Alle Fenster abrufen |
electronApp.close() | Anwendung schließen |
Android-API
| Methode/Klasse | Beschreibung |
android.devices() | Liste der verbundenen Geräte abrufen |
AndroidDevice | Android-Geräteobjekt |
AndroidWebView | WebView-Objekt |
Weitere Erweiterungen