Freitagabend mergen Sie einen Umbau des Headers. Montagmorgen meldet ein Kollege, dass der Login-Button auf der Preisseite um ein paar Pixel verrutscht ist: auf einer Seite, die Sie gar nicht angefasst hatten. Kein Test hat Alarm geschlagen, weil kein Test auf das Erscheinungsbild geachtet hat. Genau diese Lücke schließt das visuelle Testen.
Playwright von Microsoft enthält seit Version 1.22 eine native Funktion für visuelles Testen: die Methode toHaveScreenshot(). Sie nimmt Screenshots auf und vergleicht sie automatisch mit Referenzbildern, ohne externes Plugin. Es ist eine vollständig kostenlose Lösung: Weitere kostenlose Tools für visuelles Testen finden Sie in unserem Vergleich.
Für Teams, die ihrer bestehenden Suite visuelle Tests hinzufügen wollen, ist das eine der stärksten Optionen. Die Grundlagen der visuellen Regression erklärt unser kompletter Leitfaden. Dieser Leitfaden behandelt Installation, Konfiguration, bewährte Vorgehensweisen und CI/CD-Integration und zeigt dann, was das Vision SDK von Delta-QA in genau diesen Tests verändert.
Das Wichtigste auf einer Seite: was ein No-Code-Tool wirklich automatisiert und wie es im Vergleich dasteht: Testautomatisierung ohne Code.
toHaveScreenshot() zwingt Sie immer noch, Code zu schreiben und zu pflegen? Delta-QA nimmt Ihre Seiten auf und vergleicht sie ohne eine Zeile Code, ohne Kreditkarte. Delta-QA kostenlos testen →
Installation und erster Test
Der Einstieg ist schnell, wenn Sie bereits ein Node.js-Projekt haben:
npm install -D @playwright/test
npx playwright install
Legen Sie dann Ihren ersten visuellen Test in tests/visual.spec.ts an:
import { test, expect } from '@playwright/test';
test('homepage visual test', async ({ page }) => {
await page.goto('https://your-site.com');
await expect(page).toHaveScreenshot('homepage.png');
});
Beim ersten Lauf wird die Baseline (das Referenzbild) erzeugt. Die folgenden Läufe vergleichen die aktuelle Aufnahme mit dieser Baseline und melden die Unterschiede.
# Erstes Mal: Baselines erzeugen
npx playwright test --update-snapshots
# Danach: vergleichen
npx playwright test
So einfach ist der Start. Die Komplexität kommt mit den realen Fällen.
Toleranz konfigurieren
Standardmäßig meldet Playwright jede noch so kleine Abweichung von einem Pixel. In der Praxis müssen Sie Toleranzschwellen konfigurieren, um Falsch-Positive zu vermeiden.
In playwright.config.ts:
import { defineConfig } from '@playwright/test';
export default defineConfig({
expect: {
toHaveScreenshot: {
maxDiffPixelRatio: 0.01, // 1 % abweichende Pixel werden toleriert
animations: 'disabled', // deaktiviert CSS-Animationen
scale: 'device', // berücksichtigt Retina-Bildschirme
},
},
});
Sie können auch pro Test anpassen:
// Statische Seite: strenger Schwellenwert
await expect(page).toHaveScreenshot('landing.png', {
maxDiffPixelRatio: 0.001
});
// Dashboard mit Diagrammen: großzügigerer Schwellenwert
await expect(page).toHaveScreenshot('dashboard.png', {
maxDiffPixelRatio: 0.05,
mask: [page.locator('.chart')]
});
Der Schwellenwert ist ein Kompromiss: Ist er zu niedrig, lässt die kleinste Rendering-Abweichung den Test fehlschlagen; ist er zu hoch, rutscht ein Abstand, der von 16 px auf 12 px schrumpft, unbemerkt unter der Schwelle durch.
Dynamische Inhalte behandeln
Dynamische Inhalte (Datumsangaben, Werbung, Avatare, Zähler) sind der Albtraum visueller Tests. Playwright bietet drei Lösungen:
Dynamische Bereiche maskieren, die gebräuchlichste Methode:
await expect(page).toHaveScreenshot({
mask: [
page.locator('.ad-banner'),
page.locator('.timestamp'),
page.locator('.user-avatar')
]
});
Inhalte ersetzen, um Werte festzusetzen:
await page.evaluate(() => {
document.querySelector('.date').textContent = '01/01/2026';
});
await expect(page).toHaveScreenshot();
Per CSS verbergen, was überhaupt nicht erscheinen soll:
await page.addStyleTag({
content: '.dynamic-element { visibility: hidden !important; }'
});
await expect(page).toHaveScreenshot();
Jede dieser Lösungen wird von Hand gepflegt: Kommt ein neuer dynamischer Block auf die Seite, muss ein weiterer Selektor ergänzt werden.
Tests stabilisieren
Ein visueller Test, der an einem Tag besteht und am nächsten ohne Grund fehlschlägt, ist unbrauchbar. So sorgen Sie für Stabilität:
test('stable visual test', async ({ page }) => {
await page.goto('https://your-site.com');
// Warten, bis das Netzwerk ruhig ist
await page.waitForLoadState('networkidle');
// Warten, bis die Schriftarten geladen sind
await page.evaluate(() => document.fonts.ready);
// Auf ein kritisches Element warten
await page.waitForSelector('.hero-image', { state: 'visible' });
await expect(page).toHaveScreenshot();
});
Und um Animationen von Hand zu deaktivieren, wenn die globale Option nicht ausreicht:
await page.addStyleTag({
content: `
*, *::before, *::after {
animation-duration: 0s !important;
transition-duration: 0s !important;
}
`
});
Mehrere Auflösungen testen
Playwright erleichtert das Testen in mehreren Auflösungen über Projekte:
// playwright.config.ts
import { defineConfig, devices } from '@playwright/test';
export default defineConfig({
projects: [
{
name: 'Desktop',
use: { viewport: { width: 1920, height: 1080 } },
},
{
name: 'Tablet',
use: { viewport: { width: 768, height: 1024 } },
},
{
name: 'Mobile',
use: { ...devices['iPhone 13'] },
},
],
});
Jedes Projekt erzeugt seine eigenen Baselines. Ein Test läuft also dreimal, in drei Auflösungen, mit drei Aufnahmesätzen, die aktuell gehalten werden müssen.
CI/CD-Integration
Die Integration in GitHub Actions ist unkompliziert. Eine vollständige Konfiguration finden Sie in unserem Leitfaden zu Regressionstests in GitHub Actions oder, auf der GitLab-Seite, im Leitfaden zum visuellen Testen in GitLab CI.
name: Visual Tests
on: [push, pull_request]
jobs:
visual-tests:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 20
- run: npm ci
- run: npx playwright install --with-deps
- run: npx playwright test
- uses: actions/upload-artifact@v4
if: failure()
with:
name: playwright-report
path: playwright-report/
Schlägt ein Test fehl, erzeugt Playwright drei Bilder: die Baseline (erwartet), die aktuelle Aufnahme und ein Diff mit den Unterschieden in Rot. Der HTML-Bericht (npx playwright show-report) zeigt sie nebeneinander an.
Zu beachten: Das Rendering von Schriftarten variiert von System zu System. Auf einem Mac erzeugte Baselines passen nicht zu den Aufnahmen des Linux-Runners der CI. Erzeugen Sie sie in der CI oder im offiziellen Docker-Image von Playwright.
toHaveScreenshot() verlangt von Ihnen immer noch, Code zu schreiben? Delta-QA nimmt Ihre Seiten auf und vergleicht sie No-Code, ohne Kreditkarte. Delta-QA kostenlos testen →
Die Grenzen des Playwright-Ansatzes
Playwright ist hervorragend für Teams, die ihre Tests selbst schreiben, doch toHaveScreenshot() hat Grenzen, die man kennen sollte:
Zwingende Kenntnisse: Sie müssen TypeScript/JavaScript, Selektoren und Projektkonfiguration beherrschen. QA-Tester, die keinen Code schreiben, können diese Tests weder erstellen noch pflegen.
Keine Review-Oberfläche: Es gibt keinen gemeinsamen Bereich, um die Unterschiede zu beurteilen. Die Verwaltung der Baselines läuft über das Terminal und das Dateisystem. Im Team wird das schnell komplex.
Ein Pixelvergleich: Der Diff zeigt einen roten Bereich, nicht was sich geändert hat. Anti-Aliasing-Unterschiede zwischen Browsern, Abweichungen beim Rendering von Schriftarten zwischen Betriebssystemen: All das erzeugt Rauschen, das von Hand mit Masken und Schwellenwerten bewältigt werden muss.
Wartung: Jede gewollte Änderung der Oberfläche zwingt dazu, die Baselines neu zu erzeugen (--update-snapshots). Bei einem Projekt mit 200 visuellen Tests und 3 Browsern sind das 600 Baselines, die im Repository versioniert verwaltet werden. Unser Leitfaden zur Verwaltung von Baselines beschreibt Strategien, sie zu pflegen.
Playwright behalten, den Vergleich wechseln: das Vision SDK
Wenn Ihre Playwright-Tests schon existieren, müssen Sie sie nicht verlassen, um einen Teil dieser Grenzen aufzuheben. Das Vision SDK von Delta-QA (@delta-qa/vision) fügt eine Delta-QA-Prüfung dort hinzu, wo der Test die Seite ansehen soll:
import { test } from "@delta-qa/vision/fixture";
test("Checkout", async ({ page, vision }) => {
const checkout = await vision.open(page, { id: "checkout", name: "Checkout" });
await page.goto("https://shop.example.com/checkout");
await checkout.check("Payment");
}); // von der Fixture geschlossen: Eine nicht beurteilte Abweichung lässt den Test fehlschlagen
Das SDK liest den API-Schlüssel aus der Variable DELTAQA_API_KEY. Ohne die Fixture öffnet open(page, { … }) aus @delta-qa/vision denselben Test, und close() schließt ihn in einem afterEach.
Was sich gegenüber toHaveScreenshot() ändert:
- Der Bericht nennt das Element, das sich geändert hat. Kein roter Bereich, den man deuten muss: Der Bericht sagt, welches Element sich geändert hat, zum Beispiel der Button „Bezahlen“, der von Blau zu Grün wechselte.
- Die Referenzen leben nicht mehr im Repository. Beim ersten Lauf wird jeder Check zur Referenz. Danach lässt eine nicht beurteilte Abweichung den Test fehlschlagen, und das CI-Protokoll nennt den Link zum Bericht. Dort beurteilen Sie jede Abweichung: „Gewollt“ oder „Bug“.
- Eine Referenz pro Branch. Der Test gibt seinen Branch und seinen Basis-Branch an (
branch,baseBranch): Ein neuer Branch wird ab dem ersten Lauf mit seinem Basis-Branch verglichen, und „Gewollt“ gilt nur für die Branches, die Sie ankreuzen. - Der Rest des Tests bleibt gleich. Die Projekte aus
playwright.config.tsgelten weiterhin: Jede Bildschirmgröße hat ihre eigene Referenz. Einzige Bedingung: eine Bildschirmdichte von 1 (deviceScaleFactor: 1).
Das SDK deckt Playwright in TypeScript und JavaScript auf Chromium ab. Es wird zunächst als Early Access angeboten: Den Zugang beantragen Sie auf seiner Seite.
Und für alle, die keine Tests schreiben
Playwright-Tests bleiben Code. Damit auch QA-Tester, Product Owner oder Designer das Erscheinungsbild der Anwendung prüfen können, bieten No-Code-Lösungen wie Delta-QA einen anderen Weg: Man zeichnet einen Ablauf im Browser auf, Delta-QA spielt ihn bei jeder Version erneut ab und vergleicht jeden Schritt mit seiner Referenz. Diese Szenarien und die Checks des Vision SDK werden im selben Delta-QA-Bereich beurteilt, mit demselben Bericht.
Lust, ohne eine Zeile TypeScript und ohne eine einzige neu zu erzeugende Baseline zu testen? Vergleichen Sie Ihre Seiten jetzt mit Delta-QA, kostenlos und ohne Kreditkarte. Delta-QA kostenlos testen →
FAQ
Ist Playwright für visuelle Tests kostenlos?
Ja, vollständig. toHaveScreenshot() ist nativ in Playwright integriert, das Open Source ist und von Microsoft gepflegt wird. Keine Lizenz, keine Begrenzung der Screenshots.
Wie lange dauert die Einrichtung visueller Tests mit Playwright?
Beherrschen Sie Playwright bereits, rechnen Sie mit einigen Stunden für Konfiguration und die ersten Tests. Starten Sie bei null (Installation, TypeScript lernen, CI konfigurieren), rechnen Sie mit 2 bis 3 Tagen.
Playwright oder Cypress für visuelle Tests?
Playwright hat den Vorteil, visuelles Testen nativ zu integrieren (toHaveScreenshot()), während Cypress ein externes Plugin braucht. Playwright unterstützt außerdem drei Browser-Engines (Chromium, Firefox, WebKit), während Cypress Chromium- und Firefox-Browser unterstützt und WebKit experimentell bleibt. Details finden Sie in unserem Vergleich Playwright vs. Cypress oder Playwright vs. Selenium, wenn Sie zwischen diesen beiden Frameworks schwanken.
Kann man Playwright und Delta-QA zusammen nutzen?
Ja, und im selben Test. Mit dem Vision SDK fügen Sie vision.check() zu den Schritten hinzu, an denen die Seite geprüft werden soll: Playwright steuert den Browser und Ihre funktionalen Assertions, Delta-QA vergleicht die Seite mit ihrer Referenz. Die vom QA-Team ohne Code aufgezeichneten Abläufe werden im selben Bereich beurteilt.
Muss ich meine toHaveScreenshot() entfernen, um das Vision SDK zu nutzen?
Nein. Beide können in derselben Suite nebeneinander bestehen: Sie können auf einigen Seiten vision.check() ergänzen, die Ergebnisse vergleichen und dann Seite für Seite entscheiden, was Sie behalten.
Playwright bietet eine solide Basis für automatisierte visuelle Tests. Für Teams, die ihre Tests in TypeScript schreiben, ist toHaveScreenshot() 2026 wahrscheinlich die beste verfügbare Open-Source-Option, vorausgesetzt, die Schwellenwerte werden gut eingestellt und die Tests von Anfang an stabilisiert. Wenn der Pixel-Diff und die Baselines im Repository zur Hauptlast werden, behält das Vision SDK Ihre Tests und ändert den Vergleich. Um Playwright gegenüber anderen Tools einzuordnen, lesen Sie unseren Vergleich der Tools für Regressionstests.
