← React / TypeScript

React / TypeScript · 23 / 24

Nutzerabläufe mit Playwright testen

Du prüfst Eingabe, Speicherung und Wiederöffnung über einen echten Browser.

  • Groß
  • Anspruchsvoll
  • 90 min

Voraussetzungen: Erste React-App: JSX, Props und State, Komponenten und Repositories sinnvoll testen

In diesem Tutorial
  1. Das Zustandsmodell verstehen
  2. Das Projekt starten
  3. Den Vertrag mit einem Test prüfen
  4. Fehler und technische Grenzen beobachten
  5. Die Übung umsetzen
  6. Die Musterlösung überprüfen
  7. Übung und Lösung
  8. Projektbezug und Quellen

Lernpaket herunterladen

Einrichtung und Prüfstand

Node.js ab 22.23 mit npm. Zusätzlich Python 3 für den gemeinsamen Prüfstart. Entpacke das Lernpaket in einen neuen Ordner und führe dort python3 run_checks.py aus. Das Skript kopiert die enthaltenen Dateien in einen temporären Lernordner. Dort prüft es zuerst das Beispiel und danach die mitgelieferte Lösung. Die Ausgangsdateien bleiben erhalten. Benötigte Pakete werden beim ersten Lauf aus dem Netz geladen.

Playwright lädt Chromium. Auf einem frischen Linux-System können zusätzlich Browser-Systembibliotheken erforderlich sein. Der Start nennt fehlende Bibliotheken ausdrücklich.

Geprüft am 20.10.2026 unter Linux x86_64. Prüfe leere Eingaben, erfolgreiches Speichern und erneutes Laden. Die Lösung ergänzt eine fehlgeschlagenen Speicherzugriff. Warte auf sichtbare Zustände statt auf eine pauschale feste Pause.

Ein kompletter Ablauf prüft mehrere Grenzen gemeinsam. Hier führt eine Benutzeraktion über Formularvalidierung zur lokalen Speicherung. Ein Reload muss denselben bestätigten Datensatz zeigen. Playwright startet für jeden Test einen getrennten Browserkontext. Dadurch werden Tests nicht versehentlich vom Zustand eines vorherigen Durchlaufs abhängig.

Paketinhalt und einzelne Dateien

01Das Zustandsmodell verstehen

Ein Browsertest beschreibt eine Benutzerhandlung über sichtbare Rollen und Labels. Der Schreibzugriff auf localStorage wird für den Fehlerfall gezielt zum Scheitern gebracht. Ein Fehler soll die Eingabe bewahren, damit ein erneuter Versuch möglich bleibt.

src/App.tsx · typescriptDatei öffnen
import { useState } from "react";
function read(): string[] {
  const raw = localStorage.getItem("learning-vehicles");
  if (!raw) return [];
  try {
    const value: unknown = JSON.parse(raw);
    return Array.isArray(value) && value.every((x) => typeof x === "string")
      ? value
      : [];
  } catch {
    return [];
  }
}
export default function App() {
  const [rows, setRows] = useState<string[]>(read);
  const [error, setError] = useState("");
  return (
    <main>
      <h1>Vehicles</h1>
      <form
        onSubmit={(e) => {
          e.preventDefault();
          const form = e.currentTarget;
          const name = String(new FormData(form).get("name") ?? "").trim();
          if (!name) {
            setError("Name required");
            return;
          }
          try {
            const next = [...rows, name];
            localStorage.setItem("learning-vehicles", JSON.stringify(next));
            setRows(next);
            setError("");
            form.reset();
          } catch {
            setError("Cannot save");
          }
        }}
      >
        <label htmlFor="name">Vehicle name</label>
        <input id="name" name="name" />
        <button>Save</button>
        <p role="alert">{error}</p>
      </form>
      <ul>
        {rows.map((row, i) => (
          <li key={i}>{row}</li>
        ))}
      </ul>
    </main>
  );
}

02Das Projekt starten

Installiere die fest angegebenen Abhängigkeiten und starte npm run dev. Die Daten sind künstliche Lernwerte. Öffne die lokale Adresse und löse die Aktion einmal selbst aus.

package.json · jsonDatei öffnen
{
  "name": "appfabrik-learning",
  "private": true,
  "type": "module",
  "scripts": {
    "dev": "vite --host 127.0.0.1",
    "build": "tsc --noEmit && vite build",
    "test": "playwright test"
  },
  "dependencies": {
    "react": "19.2.3",
    "react-dom": "19.2.3",
    "react-router-dom": "7.18.4",
    "@tanstack/react-query": "5.104.5"
  },
  "devDependencies": {
    "vite": "8.1.5",
    "typescript": "6.0.3",
    "@types/react": "19.2.14",
    "@types/react-dom": "19.2.3",
    "@types/node": "22.19.15",
    "vitest": "4.1.10",
    "@testing-library/react": "16.3.2",
    "@testing-library/user-event": "14.6.1",
    "jsdom": "29.1.1",
    "@playwright/test": "1.64.1"
  }
}

03Den Vertrag mit einem Test prüfen

Prüfe leere Eingaben, erfolgreiches Speichern und erneutes Laden. Die Lösung ergänzt eine fehlgeschlagenen Speicherzugriff. Warte auf sichtbare Zustände statt auf eine pauschale feste Pause.

tests/workflow.spec.ts · typescriptDatei öffnen
import { test, expect } from "@playwright/test";
test("validated record survives reload", async ({ page }) => {
  await page.goto("/");
  await page.getByRole("button", { name: "Save" }).click();
  await expect(page.getByRole("alert")).toHaveText("Name required");
  await expect(page.getByRole("listitem")).toHaveCount(0);
  await page.getByLabel("Vehicle name").fill(" Family car ");
  await page.getByRole("button", { name: "Save" }).click();
  await expect(page.getByRole("listitem")).toHaveText(["Family car"]);
  await page.reload();
  await expect(page.getByRole("listitem")).toHaveText(["Family car"]);
});

Starten / prüfen

npm install
npm test
npm run build
Erwartetes Ergebnis

Prüfe leere Eingaben, erfolgreiches Speichern und erneutes Laden. Die Lösung ergänzt eine fehlgeschlagene Antwort. Warte auf sichtbare Zustände statt auf eine pauschale feste Pause.

04Fehler und technische Grenzen beobachten

Ändere die erwartete Ausgabe und beobachte einen fehlgeschlagenen Test. Ein TypeScript-Build schützt Typverträge, ein Browsertest schützt Interaktionen. Beide Prüfarten erfüllen unterschiedliche Aufgaben.

05Die Übung umsetzen

Erzwinge einen Speicherfehler und prüfe, dass Entwurf und bestätigte Liste korrekt bleiben.

06Die Musterlösung überprüfen

Die Lösung ersetzt setItem im Browser durch eine gezielte Exception. Der Datensatz darf nicht in der bestätigten Liste erscheinen. Die Eingabe muss für einen erneuten Versuch erhalten bleiben. Kopiere die Lösungsdateien an die entsprechenden Stellen im Lernprojekt und starte Tests und Build erneut.

Erwartetes Ergebnis

Tests und Typprüfung bestehen. Das beobachtete Ergebnis entspricht dem Lernziel.

Deine Übung

Erzwinge einen Speicherfehler und prüfe, dass Entwurf und bestätigte Liste korrekt bleiben.

Lösung mit Erklärung anzeigen

Die Lösung ersetzt setItem im Browser durch eine gezielte Exception. Der Datensatz darf nicht in der bestätigten Liste erscheinen. Die Eingabe muss für einen erneuten Versuch erhalten bleiben.

solution/workflow.spec.ts · typescriptDatei öffnen
import { test, expect } from "@playwright/test";
test("validated record survives reload", async ({ page }) => {
  await page.goto("/");
  await page.getByRole("button", { name: "Save" }).click();
  await expect(page.getByRole("alert")).toHaveText("Name required");
  await expect(page.getByRole("listitem")).toHaveCount(0);
  await page.getByLabel("Vehicle name").fill(" Family car ");
  await page.getByRole("button", { name: "Save" }).click();
  await expect(page.getByRole("listitem")).toHaveText(["Family car"]);
  await page.reload();
  await expect(page.getByRole("listitem")).toHaveText(["Family car"]);
});

test("failed storage preserves draft", async ({ page }) => {
  await page.goto("/");
  await page.evaluate(() => {
    Storage.prototype.setItem = () => {
      throw new DOMException("Full", "QuotaExceededError");
    };
  });
  await page.getByLabel("Vehicle name").fill("Draft");
  await page.getByRole("button", { name: "Save" }).click();
  await expect(page.getByRole("alert")).toHaveText("Cannot save");
  await expect(page.getByRole("listitem")).toHaveCount(0);
  await expect(page.getByLabel("Vehicle name")).toHaveValue("Draft");
});

Projektbezug und Quellen

Das eigenständige Lernprojekt vertieft ein Thema aus diesem Technologiebereich. Die Projektverweise zeigen einen festgehaltenen Quellstand als Architekturkontext. Sie sind kein Beleg dafür, dass jede hier neu eingeführte Bibliothek oder Funktion bereits in dieser App verwendet wird.