Risikobasierte Leitlinien für QA‑Ingenieure, die eine etablierte Selenium‑Suite durch Playwright ersetzen müssen, während die Verhaltensabdeckung sichtbar und auditierbar bleibt.


1. Beginnen Sie mit einem Inventar und einer Baseline

Bevor Code migriert wird, erfassen Sie das, was Sie testen. Ein konkretes Inventar verringert die Wahrscheinlichkeit eines "stillen" Abdeckungsverlusts.

Exportieren Sie dieses Inventar in eine gemeinsame Tabelle oder eine leichte Markdown-Tabelle, die das gesamte Team bearbeiten kann. Behandeln Sie es als Definition der Abdeckung für das Migrationsprojekt.


2. Erstellen Sie ein Paritäts‑Ledger

Ein Paritätsregister ist ein lebendiges Dokument, das jedes Selenium-Szenario seinem Playwright-Gegenstück zuordnet und den Äquivalenzstatus dokumentiert.

Wie man das Paritätsregister benutzt

  1. Erstellen Sie den Eintrag, sobald ein Playwright-Test entworfen wird.
  2. Markieren Sie "Erwartete Unterschiede" für jede absichtliche Änderung (z. B. Verwendung von Playwrights expect(page).toHaveURL(url) statt Seleniums assertEquals(url, expectedUrl)).
  3. Nachweise sammeln – Die eingebaute Trace-Datei (trace.zip) oder Screenshots des Playwrights sind dem Eintrag im Paritätsregister angehängt.
  4. Rollback-Status setzen – ✅ Ready, wenn der neue Test parallel zum alten durchgeführt wurde und die Ergebnisse mit dem Baseline übereinstimmen; ansonsten bleibt er ⏳ Pending.

Das Paritätsregister ist eine Prüfspur der gesammelten Nachweise; es unterstützt eine Entscheidung über die Abdeckung, kann aber allein nicht nachweisen, dass kein Verhalten übersehen wurde.


3. Explizite Wartezeiten ersetzen – Nutzen Sie Playwrights Actionability & Auto‑Retry

Selenium-Tests enthalten oft Muster wie:

new WebDriverWait(driver, Duration.ofSeconds(10))
    .until(ExpectedConditions.elementToBeClickable(By.id("submit")));
driver.findElement(By.id("submit")).click();

Die Philosophie des Playwrights lautet "Automatisch auf das Richtige warten". Das Äquivalent in TypeScript ist:

await page.getByRole('button', { name: 'Submit' }).click(); // waits for the locator to satisfy actionability checks

Wichtige Punkte

Wichtig: Auto-Waiting garantiert nicht, dass der UI-Zustand mit der Geschäftsregel übereinstimmt. Behalten Sie explizite Assertions, die das erwartete Ergebnis kodieren (z. B. "Bestellbestätigungsnummer erscheint").

Quellen: Dokumentation des Playwrights zu auto-waiting und Locators.


4. Seiten-/Komponentenabstraktionen bewahren

Wenn deine Selenium-Suite bereits ein Page Object Model (POM) verwendet, kannst du die Struktur migrieren und die Implementierung auf Playwright übertragen.

// src/pages/LoginPage.ts
import { Locator, Page } from '@playwright/test';

export class LoginPage {
  readonly page: Page;
  readonly username: Locator;
  readonly password: Locator;
  readonly submitBtn: Locator;

  constructor(page: Page) {
    this.page = page;
    this.username = page.getByLabel('Username');
    this.password = page.getByLabel('Password');
    this.submitBtn = page.getByRole('button', { name: 'Login' });
  }

  async login(user: string, pass: string) {
    await this.username.fill(user);
    await this.password.fill(pass);
    await this.submitBtn.click();
  }
}

fachliche Assertions in den Testdateien behalten statt in Seitenobjekten. Dies folgt Seleniums dokumentierten Page Object-Richtlinien und hält die Verifikationsintention sichtbar; Playwright-Seitenobjekte können weiterhin Locatoren und benutzerorientierte Operationen kapseln.


5. Fixture- und Browser-Kontextisolation

Playwrights Testrunner (@playwright/test) bietet integrierte Fixtures für Browser-, Kontext- und Seitenisolation. Ein minimales playwright.config.ts, das isolierte Tests und drei Browser-Engine-Projekte definiert, könnte aussehen wie folgt:

import { defineConfig, devices } from '@playwright/test';

export default defineConfig({
  testDir: './tests',
  timeout: 30_000,
  expect: { timeout: 5_000 },
  fullyParallel: true,
  Wiederholungsversuche: process.env.CI ? 2 : 0,
  reporter: [['list'], ['html']],
  use: {
    headless: true,
    viewport: { width: 1280, height: 720 },
    ignoreHTTPSErrors: true,
    trace: 'on-first-retry',
  },
  projects: [
    { name: 'chromium', use: { ...devices['Desktop Chrome'] } },
    { name: 'firefox', use: { ...devices['Desktop Firefox'] } },
    { name: 'webkit', use: { ...devices['Desktop Safari'] } },
  ],
});

Wichtige Erkenntnisse


6. Browserübergreifende Projekte & CI-Integration

GitHub Actions kann die drei Playwright-Projekte parallel ausführen, ähnlich wie ein Selenium Grid. Ein kurzer Workflow-Ausschnitt:

name: Playwright Tests
on: [push, pull_request]

jobs:
  e2e:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        browser: [chromium, firefox, webkit]
    steps:
      - uses: actions/checkout@v4
      - name: Set up Node
        uses: actions/setup-node@v4
        with:
          node-version: '20'
      - run: npm ci
      - run: npx playwright install --with-deps ${{ matrix.browser }}
      - run: npx playwright test --project=${{ matrix.browser }}
        env:
          CI: true

Der Workflow verwendet eine offizielle GitHub-Aktionsmatrix, um die konfigurierten Playwright-Projekte separat auszuführen; Berichte und Traces werden als Workflow-Artefakte veröffentlicht, wenn das Team aufbewahrte Nachweise benötigt.


7. Doppelbetrieb von alten und neuen Suiten

Um zu beweisen, dass die Abdeckung unverändert ist, führen Sie beide Suites auf demselben Commit aus:

  1. Selenium Suite ausführen → JUnit-XML, Screenshots und einen Fehlerbericht generieren.
  2. Playwright-Suite ausführen → dieselben Artefakte generieren (Playwright kann JUnit XML über --reporter=junit ausgeben).
  3. Vergleiche die abgebildete fachliche Absicht und das erwartete Ergebnis automatisch. Behandeln Sie Unterschiede bei Bestehen/Nicht als Untersuchungssignale, nicht als Äquivalenznachweis, da Timing, Daten oder Umgebung zwischen Durchläufen variieren können.

Wenn eine Unstimmigkeit auftritt, markieren Sie den entsprechenden Paritäts-Ledger-Eintrag zur Untersuchung, bevor Sie fortfahren.


8. Delta-Klassifikation & Flake-Budget

Wenn Unterschiede auffallen, klassifizieren Sie sie:

Definieren Sie ein teameigenes Flake-Budget aus dem aktuellen Baseline und verfolgen Sie es im Paritätsregister. Playwright-Wiederholungen können helfen, einen Test als flaky zu klassifizieren, aber Wiederholungen dürfen nicht dazu verwendet werden, Instabilität zu verbergen; der Fehler im ersten Lauf und das Ergebnis des erneuten Versuchs sollten beide sichtbar bleiben.


9. Stufenweise Cut‑Over- und Rollbackkriterien

Eine risikoscheue Migration verläuft in Etappen:

Rollback bedeutet, den erhaltenen Selenium-CI-Job durch eine überprüfte Konfigurationsänderung wieder zu aktivieren, während die Playwright-Implementierung zur Diagnose und Korrektur verfügbar bleibt.


10. Migrations-QA-Checkliste


11. Wo Automatisierung hilft

Automatisierung ersetzt nicht das menschliche Urteil darüber, was fachliche Korrektheit ausmacht; sie macht lediglich die Migrationsbeweise reproduzierbar und prüfbar.


12. Fazit

Die Migration einer etablierten Selenium-Suite zu Playwright ist keine einfache Copy-Paste-Übung. Durch Inventarisierung der bestehenden Abdeckung, Aufbau eines Paritätsregisters und Betrieb beider Suiten nebeneinander können Teams Risiken quantifizieren und nachweisen, dass keine Verhaltensunterschiede festgestellt wurden. Playwrights automatisches Warten, robustes Tracing und integrierte Fixtures vereinfachen die Testwartung, müssen aber durch explizite Assertions ergänzt werden, die die wahre fachliche Absicht erfassen. Ein phasenhafter Cut-over, klare Rollbackkriterien und ein diszipliniertes Flake-Budget halten die Migration unter Kontrolle. Mit diesem risikobasierten Ansatz hält der Übergang das Migrationsrisiko sichtbar und liefert Rereproduzierbare Nachweise, um zu entscheiden, wann jede kritische Nutzerablauf zum Cutover bereit ist.


Fragen zur Selbstkontrolle

  1. Welche drei Informationen sollten für jeden Selenium-Test vor der Migration erfasst werden?
  2. Wie unterscheidet sich Playwrights automatisches Warten von Seleniums expliziter WebDriverWait, und warum müssen Assertions weiterhin explizit sein?
  3. Was ist der Zweck eines Paritätsregisters und welche Felder sind für die Prüfbarkeit unerlässlich?
  4. Beschreiben Sie eine konkrete Möglichkeit, die Tracing-Funktion von Playwright im Migrationsprozess zu nutzen.
  5. Nennen Sie zwei Kriterien, die während des stufenweisen Cut-over einen Rollback auslösen würden.

Quellen