Ein CSS-Update, eine neue Extension-Version oder ein geändertes Template, und plötzlich verschiebt sich auf einer Unterseite das Layout. Solche Fehler fallen oft erst Kunden auf. Visuelle Regressionstests vergleichen Screenshots einer Seite mit einem freigegebenen Referenzbild und schlagen Alarm, wenn sich etwas unerwartet verändert. Wir setzen dafür in TYPO3-Projekten Playwright ein. Die im Juli 2026 erschienene Version 1.62 bringt zwei Neuerungen, die genau diesen Anwendungsfall betreffen.
WebP für Referenzbilder
toHaveScreenshot() kann Referenzbilder jetzt als WebP speichern, wenn der Dateiname auf .webp endet. Für diese Vergleiche nutzt Playwright verlustfreies WebP, die Genauigkeit des Pixelvergleichs bleibt also erhalten. Zusätzlich akzeptieren page.screenshot() und locator.screenshot() den Typ webp. Ein quality-Wert von 100 ist dabei der verlustfreie Standard, niedrigere Werte komprimieren verlustbehaftet.
Für die Praxis heißt das: Referenzbilder im Repository werden kleiner, ohne dass die Tests an Aussagekraft verlieren. Bei Projekten mit vielen Seiten, mehreren Viewports und Browsern summiert sich das schnell.
Isolierte Wiederholungen
Neu ist außerdem die Option retryStrategy. Standardmäßig, mit dem Wert immediate, wird ein fehlgeschlagener Test wiederholt, sobald ein Worker frei ist. Mit isolated laufen alle Wiederholungen am Ende, nacheinander in einem einzelnen Worker. Das soll gegenseitige Beeinflussung mit dem Rest der Testsuite verringern.
Gerade visuelle Tests reagieren empfindlich auf Last: Schriften laden verzögert, Animationen sind noch nicht abgeschlossen. Wenn ein Test nur deshalb fehlschlägt, weil parallel zu viel passiert, hilft eine isolierte Wiederholung, echte Fehler von Zufallstreffern zu unterscheiden.
Weitere Neuerungen
- Playwright bündelt nun den Playwright-MCP-Server und
playwright-cli. - Viele Operationen akzeptieren ein
signalzum Abbrechen. - Debian 11 wird nicht mehr unterstützt.
Unser Vorgehen
Bewährt hat sich, Referenzbilder in derselben Umgebung zu erzeugen, in der auch die Tests laufen, also etwa im DDEV-Container oder in der CI-Pipeline. Dynamische Inhalte wie Datumsangaben oder Slider werden ausgeblendet oder angehalten. So bleiben Abweichungen aussagekräftig.
Was heißt das für Ihr Projekt?
Wenn Sie bereits mit Playwright testen, lohnt sich ein Blick auf WebP-Referenzbilder und die isolierte Retry-Strategie. Haben Sie noch keine visuellen Tests, sind sie vor einem größeren Update oder Relaunch eine sinnvolle Absicherung. Wir richten solche Tests gern für Ihre TYPO3-Website ein.