E2E-Tests
Regeln
- Playwright für E2E — Cross-Browser, automatische Wartezeiten, integrierter Testläufer, hervorragende CI-Unterstützung
- Locator-Priorität:
getByRole() > getByLabel() > getByPlaceholder() > getByTestId() > CSS-Selektoren
- Page Object Model: Kapsle Seiteninteraktionen in Klassen —
LoginPage.login(email, password)
- Testisolierung: Jeder Test startet mit frischem Zustand — verwende
beforeEach für die Einrichtung, vermeide Testabhängigkeiten
- Automatische Wartezeiten: Playwright wartet automatisch auf Elemente — füge keine manuellen
waitForTimeout()-Aufrufe hinzu
- Assertions: Verwende web-first Assertions mit
expect(locator) — toBeVisible(), toHaveText(), toHaveURL()
- Parallele Ausführung: Tests laufen standardmäßig parallel — stelle sicher, dass keine gemeinsam genutzten veränderlichen Zustände zwischen Tests bestehen
- CI: Führe Tests im Headless-Modus aus, konfiguriere Wiederholungen (
retries: 2 in CI), lade Trace bei Fehlschlag hoch
- Visuelles Regressionstesting:
expect(page).toHaveScreenshot() — aktualisiere Baselines mit --update-snapshots
Muster
class LoginPage {
constructor(private page: Page) {}
async goto() { await this.page.goto("/login"); }
async login(email: string, password: string) {
await this.page.getByLabel("Email").fill(email);
await this.page.getByLabel("Password").fill(password);
await this.page.getByRole("button", { name: "Anmelden" }).click();
await this.page.waitForURL("/dashboard");
}
}
export default defineConfig({
retries: process.env.CI ? 2 : 0,
use: { trace: "on-first-retry", screenshot: "only-on-failure" },
projects: [
{ name: "chromium", use: { ...devices["Desktop Chrome"] } },
{ name: "mobile", use: { ...devices["Pixel 5"] } },
],
});
Vermeide
page.waitForTimeout() — verwende automatische Wartezeiten oder waitForURL(), waitForResponse()
- CSS-Selektoren für interaktive Elemente — verwende rollenbasierte Locators für Robustheit
- Tests, die vom Zustand anderer Tests abhängen — jeder Test muss unabhängig ausführbar sein
- Direktes Testen von Drittanbieterdiensten — mocke externe APIs mit
page.route()
- Überspringen mobiler Viewports — teste mindestens ein mobiles Gerät in deiner Projektmatrix