Zum Inhalt springen

Serie

End-to-End-Tests mit Playwright: Frontend, Backend und Datenbank

Richte Playwright für eine ganze App ein, in vier Bereichen mit je einer Aufgabe: die Datenbank, die API, das Frontend gegen eine gemockte API und ein paar Abläufe durch alles hindurch. Parallel, mit einer Datenbank pro Worker, und am Ende in deiner Pipeline.

Fortgeschritten14 Teile · etwa 6 Std.

Vierzehn Teile, von einer kleinen App ohne einen einzigen Test bis zu einer Suite, die bei jedem Push jede Schicht prüft. Die App ist ein Quest Board mit einem Vue-Frontend, einer Hono-API und einer PostgreSQL-Datenbank, und die Suite bekommt ein Playwright-Projekt pro Schicht: Die Datenbank-Tests sprechen SQL, die Backend-Tests schicken Anfragen, die Frontend-Tests steuern einen Browser gegen eine gemockte API, und eine Handvoll End-to-End-Tests geht durch alles auf einmal. Wenn etwas kaputtgeht, sagt dir der Bereich, der rot wird, wo du suchen musst. Du gibst jedem parallelen Worker eine eigene Datenbank und einen eigenen Server, damit Tests einander nie sehen, lernst einen Trace zu lesen, wenn einer fehlschlägt, loggst dich einmal für die ganze Suite ein und ergänzt Prüfungen der Barrierefreiheit und Screenshot-Vergleiche. Am Ende lässt GitHub oder GitLab alles in demselben Container laufen, in dem es auch auf deinem Rechner läuft.

Mit Teil 1 beginnen

Questreihe

  1. Die App, die wir testenSieh dir an, wie die Suite dieser Serie aufgebaut ist, in vier Bereichen mit je einer Aufgabe, und bau dann die kleine App, die sie testet: ein Quest Board mit Vue-Frontend, Hono-API und PostgreSQL-Datenbank.35 Min.
  2. Dein erster Playwright-TestInstallier Playwright, lass es die App selbst starten und schreib einen Test, der das Quest Board in einem echten Browser öffnet und eine Quest anlegt. Dann finde heraus, warum ein grüner Test trotzdem falsch sein kann.20 Min.
  3. Eine Konfiguration, vier ProjekteTeil die Suite in vier Playwright-Projekte auf, eines für jede Schicht der App: Datenbank, Backend, Frontend und Ende zu Ende. Jedes bekommt einen ersten kleinen Test, der zeigt, welche Art von Test dort zu Hause ist.20 Min.
  4. Eine Datenbank für jeden WorkerGib jedem parallelen Worker eine eigene Kopie der Datenbank, erzeugt aus einem Template, das die echten Migrationen bauen, und jedem Test leere Tabellen. Dann laufen die Tests parallel und in beliebiger Reihenfolge, und deine Entwicklungsdaten bleiben unberührt.25 Min.
  5. Die Datenbank testenFüll den Bereich für die Datenbank: Tests für die Standardwerte und Constraints der Tabelle, für die Abfragen der App, und ein Test, der bemerkt, wenn schema.ts geändert wurde und die Migration dazu fehlt.25 Min.
  6. Das Backend testenLass jeden Worker seine eigene Kopie der API auf seiner eigenen Datenbank starten und teste dann jeden Endpunkt mit echten HTTP-Anfragen: den Status, den Body und die Zeile, die danach in der Datenbank steht.25 Min.
  7. Das Frontend testenTeste die Seite in einem echten Browser, während der Test die API spielt: ein Page Object, eine Sperre für Anfragen, die niemand gemockt hat, und zwölf Tests für Zustände, die ein echtes Backend selten zeigt, vom Laden bis zum Ausfall.30 Min.
  8. Ende zu Ende, durch alle SchichtenBau das Frontend, lass den eigenen Server jedes Workers es ausliefern und schreib fünf Tests, die durch Browser, API und Datenbank zugleich gehen. Danach berührt kein Test mehr deine Entwicklungsumgebung.25 Min.
  9. Wenn ein Test fehlschlägtMach die App mit Absicht kaputt und folge der Spur: welche Bereiche rot werden, was der Fehler sagt, und wie der Trace die Seite, die Aktionen und das Netzwerk in dem Moment zeigt, in dem es schiefging.25 Min.
  10. Ein Login für das Quest BoardDie App wächst: Lesen darf das Quest Board weiterhin jeder, ändern nur noch, wer als Mitglied eingeloggt ist. Bau den Login durch alle drei Schichten, lass die Suite laufen und lies, warum die Hälfte davon rot wird.30 Min.
  11. Einmal einloggen, überall testenLass ein Setup-Projekt ein einziges Mal einloggen, speichere das Cookie als Storage State und starte jeden Test damit, der ein Mitglied braucht. Die roten Tests werden ohne Änderung grün, und der Login bekommt eigene Tests in allen vier Bereichen.35 Min.
  12. Barrierefreiheit prüfen mit axeLass axe bei jedem Lauf vier Zustände des Quest Boards ansehen, behebe, was es findet, und dann das, was es nicht finden konnte: ein Feld, dessen Beschriftung nie jemand sieht. Ein ARIA-Snapshot hält fest, was ein Screenreader erfährt.20 Min.
  13. Visuelle VergleicheMach Bilder vom Quest Board und lass Playwright sie bei jedem Lauf vergleichen, damit eine CSS-Änderung, die etwas verschiebt, als fehlgeschlagener Test auffällt. Die Bilder entstehen immer im selben Container, denn nur dort lassen sie sich fair vergleichen.25 Min.
  14. Die Tests in deiner PipelineLass GitHub oder GitLab bei jedem Push alle vier Bereiche ausführen, im selben Container, in dem sie auf deinem Rechner laufen, mit einer Datenbank daneben und einem Report, der von jedem Lauf aufbewahrt wird, auch von den roten.20 Min.