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

// Dateipfad: tests/describe-demo.spec.ts
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('Benutzermodul', () => {

  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

// Direkt überspringen (oft verwendet, um fehlschlagende Feature-Tests vorübergehend zu deaktivieren)
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

// Als erwarteter Fehler markiert (wird nicht als Testfehler gemeldet)
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

// Während der Entwicklung und beim Debugging nur den aktuellen Test ausführen
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

// Als zu reparieren markiert (wird nicht ausgeführt)
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

// Als langsamer Test markiert, Timeout wird verdreifacht
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

// Dateipfad: tests/hooks-demo.spec.ts
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.describe('Benutzerverwaltung', () => {
  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

// Hook auf Dateiebene — gilt für die gesamte Datei

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"。

Andere Erweiterungen