Playwright Teststruktur und Hooks
Dieses Kapitel stellt vor, wie Playwright-Tests organisiert werden, einschließlich Testgruppierung, Ausführungssteuerung und der Verwendung von Lebenszyklus-Hooks.
test.describe() Testgruppierung
test.describe()Wird verwendet, um zusammengehörige Tests in logischen Gruppen zusammenzufassen.
Beispiel
import { test, expect } from '@playwright/test';
// Gruppierung auf erster Ebene
test.describe('BEISPIEL-Homepage-Test', () => {
test('Seitentitel ist korrekt', async ({ page }) => {
await page.goto('https://www.example.com/');
await expect(page).toHaveTitle(/EXAMPLE/);
});
test('Navigationsleiste ist vorhanden', async ({ page }) => {
await page.goto('https://www.example.com/');
// Überprüfen, dass das Navigationselement existiert
await expect(page.locator('nav')).toBeVisible();
});
});
// Mehrere describe-Blöcke können definiert werden
test.describe('Test der Suchfunktion', () => {
test('Suchfeld ist sichtbar', async ({ page }) => {
await page.goto('https://www.example.com/');
await expect(
page.getByPlaceholder('Suche')
).toBeVisible();
});
});
Der Testbericht wirddescribein Gruppen angezeigt, sodass die Ergebnisse leicht zu überblicken sind.
Verschachtelte describe-Blöcke
test.describe()Sie können verschachtelt werden, um eine Baumstruktur zu bilden:
Beispiel
test.describe('Anmeldefunktionalität', () => {
test('Login mit korrektem Konto und Passwort', async ({ page }) => { /* ... */ });
test('Login schlägt mit falschem Passwort fehl', async ({ page }) => { /* ... */ });
});
test.describe('Registrierungsfunktionalität', () => {
test('Registrieren mit korrekten Informationen', async ({ page }) => { /* ... */ });
test('Registrierung schlägt bei existierender E-Mail fehl', async ({ page }) => { /* ... */ });
});
});
test.skip() Tests überspringen
test.skip()Wird verwendet, um einen Test zu überspringen; übersprungene Tests werden nicht ausgeführt.
Beispiel
test.skip('Feature-Test noch nicht abgeschlossen', async ({ page }) => {
// Dieser Test wird nicht ausgeführt
});
// Bedingtes Überspringen (zur Laufzeit bestimmt)
test('Unter bestimmten Bedingungen überspringen', async ({ page, browserName }) => {
// In Firefox überspringen
test.skip(browserName === 'firefox', 'Firefox unterstützt diese Funktion noch nicht');
// Testlogik läuft nur in Nicht-Firefox-Browsern
await page.goto('https://www.example.com/');
});
test.fail() Erwarteten Fehler markieren
test.fail()Wird verwendet, um einen Test zu markieren, der bekanntermaßen fehlschlägt.
Beispiel
test.fail('Bekannter Fehler: Suchfunktion ist noch nicht implementiert', async ({ page }) => {
await page.goto('https://www.example.com/');
// Diese Assertion wird voraussichtlich fehlschlagen
await expect(page.locator('.search-results')).toBeVisible();
});
// Wenn der Test unerwartet besteht, wird er als Fehler gemeldet
// Dies erinnert dich daran: "Der Fehler ist behoben, du kannst die test.fail-Markierung jetzt entfernen"
test.fail()Sein Zweck ist die umgekehrte Markierung: Testfehler = wie erwartet, Testbestehen = abnormal (Markierung muss möglicherweise entfernt werden).
test.only() Nur den aktuellen Test ausführen
test.only()Wird verwendet, um während der Entwicklung und beim Debugging nur bestimmte Tests auszuführen und andere Tests in der Datei zu ignorieren.
Beispiel
test.only('Ich debugge diesen Test', async ({ page }) => {
// Nur dieser Test wird ausgeführt
await page.goto('https://www.example.com/');
});
test('Dieser Test wird ignoriert', async ({ page }) => {
// Wegen des obigen test.only() wird dieser nicht ausgeführt
});
test.only()ist ein Debugging-Werkzeug und sollte nicht im Code-Repository committet werden. Wenn Sieplaywright.config.tssetzen ... inforbidOnly: true, wird CI erkennenonlyund den Build fehlschlagen lassen.
test.fixme() Als zu beheben markieren
test.fixme()undtest.skip()Ähnlich, aber semantisch bedeutet es "Dieser Test muss repariert werden."
Beispiel
test.fixme('Login-Ablauf muss aufgrund von API-Änderungen aktualisiert werden', async ({ page }) => {
// Dieser Test wird vorerst nicht ausgeführt
});
test.slow() Langsame Tests markieren
test.slow()Erhöht das Test-Timeout um das Dreifache.
Beispiel
test.slow('Test mit großem Datenvolumen', async ({ page }) => {
// Das Standard-Timeout für diesen Test beträgt 90 Sekunden (30s × 3)
// Geeignet für Szenarien, die aufwendiges Laden von Daten oder komplexe Berechnungen erfordern
});
Test-Hooks
Hook-Funktionen ermöglichen es Ihnen, Setup- und Aufräumarbeiten in verschiedenen Testphasen durchzuführen.
test.beforeEach() und test.afterEach()
beforeEachWird vor jedem Test ausgeführt,afterEachund wird nach jedem Test ausgeführt.
Beispiel
import { test, expect } from '@playwright/test';
test.beforeEach(async ({ page }) => {
// Vor jedem Test zur selben Seite navigieren
await page.goto('https://www.example.com/');
});
test.afterEach(async ({ page }) => {
// Nach jedem Test Aufräumen durchführen (z. B. erstellte Daten entfernen)
// Playwright räumt Browserkontexte automatisch auf,
// Das Aufräumen hier bezieht sich hauptsächlich auf serverseitigen Zustand
console.log('Test beendet, Aufräumen wird gestartet...');
});
test('Erster Test', async ({ page }) => {
// page ist bereits auf der EXAMPLE-Startseite
await expect(page).toHaveTitle(/EXAMPLE/);
});
test('Zweiter Test', async ({ page }) => {
// page ist ebenfalls bereits auf der EXAMPLE-Startseite
// Dies ist ein brandneuer Kontext; Cookies/Speicher aus dem vorherigen Test werden nicht beibehalten
await expect(page.locator('nav')).toBeVisible();
});
test.beforeAll() und test.afterAll()
beforeAllInIm aktuellen Gültigkeitsbereich,wird einmal vor allen Tests ausgeführt,afterAllund wird einmal nach allen Tests ausgeführt.
Beispiel
test.beforeAll(async ({ browser }) => {
// Erstelle einen Testbenutzer vor allen Tests (wird nur einmal ausgeführt)
// Hinweis: beforeAll kann die page-Fixture nicht verwenden
});
test.afterAll(async ({ browser }) => {
// Testbenutzer nach allen Tests löschen (nur einmal ausgeführt)
});
test('Benutzerliste anzeigen', async ({ page }) => { /* ... */ });
test('Benutzerinformationen bearbeiten', async ({ page }) => { /* ... */ });
});
beforeAllundafterAllkann nicht zugreifenpageauf die Fixture, weil page für jeden Test unabhängig ist. Wenn Sie auf einer Seite arbeiten müssen, verwenden SiebeforeEach。
Geltungsbereich und Ausführungsreihenfolge von Hooks
Der Geltungsbereich von Hooks hängt davon ab, wo sie definiert sind:
Beispiel
test.beforeEach(async () => {
console.log('beforeEach auf Dateiebene');
});
test.describe('Gruppe A', () => {
// Hook auf Gruppenebene — gilt nur für Gruppe A
test.beforeEach(async () => {
console.log("beforeEach von Gruppe A");
});
test('Test A1', async () => { /* ... */ });
test('Test A2', async () => { /* ... */ });
});
test.describe('Gruppe B', () => {
// Gruppe B hat keine eigenen Hooks; nur der Hook auf Dateiebene wird wirksam
test('Test B1', async () => { /* ... */ });
});
Ausführungsreihenfolge: äußere Hooks laufen zuerst, innere Hooks danach.
Für A1 und A2: zuerst Ausgabe"文件级 beforeEach", dann Ausgabe"分组 A 的 beforeEach"。
Für B1: nur Ausgabe"文件级 beforeEach"。