{"canonical_url":"https://engineer.company/de/glossary/playwright/","content_markdown":"# Playwright\n\n## Was es ist\n\nPlaywright ist ein quelloffenes Framework von Microsoft zur Automatisierung von\nWebbrowsern, mit einer Programmierschnittstelle für Chromium, Firefox und\nWebKit. Playwright Test, auf npm als `@playwright/test` veröffentlicht, ist der\ndarauf aufgebaute Testrunner. Ihn meinen die meisten Menschen, wenn sie den\nNamen verwenden. Dasselbe Projekt liefert die reine Bibliothek für Skripte,\ndie keine Tests sind, ein Kommandozeilenwerkzeug, einen an KI-Agenten\ngerichteten MCP-Server und eine Erweiterung für Visual Studio Code. Alles steht\nunter der Apache License 2.0.\n\nNeben JavaScript und TypeScript ist dieselbe Browsersteuerung auch in Python\nverfügbar, wo das Projekt sein pytest-Plugin empfiehlt, in Java mit beliebigen\nTestframeworks wie JUnit und in .NET mit Basisklassen für MSTest, NUnit und\nxUnit.\n\n`npx playwright install` lädt die eigenen Builds der drei Engines herunter.\nDa jede Veröffentlichung auf neuere Versionen dieser Engines wechselt, muss der Befehl nach einem\nUpgrade möglicherweise erneut ausgeführt werden. Playwright kann auch Google\nChrome und Microsoft Edge steuern, wenn sie bereits auf dem Rechner installiert\nsind. Tests laufen standardmäßig headless, also ohne sichtbares Fenster. Das\nBeispiel der Installationsanleitung führt Tests über konfigurierte\nBrowser-Projekte parallel in allen drei Engines aus. Ohne diese Projekte ist\nChromium der Standardbrowser des Runners. Jeder Test erhält einen neuen\nBrowserkontext, der einem neuen Browserprofil entspricht. Cookies und\ngespeicherte Browserdaten eines Tests gelangen dadurch nicht in den nächsten.\n\nEin Test liest sich wie die Schritte, die ein Mensch ausführen würde:\n\n```js\nimport { test, expect } from \"@playwright/test\";\n\ntest(\"signing in opens the inbox\", async ({ page }) =\u003e {\n    await page.goto(\"https://example.com/sign-in\");\n    await page.getByLabel(\"Email\").fill(\"reader@example.com\");\n    await page.getByRole(\"button\", { name: \"Sign in\" }).click();\n    await expect(page.getByRole(\"heading\", { name: \"Inbox\" })).toBeVisible();\n});\n```\n\nZwei Mechanismen leisten den größten Teil der Arbeit. Vor einer Aktion führt\nPlaywright Prüfungen der Ausführbarkeit durch und wartet, bis alle bestanden\nsind. Für einen Klick muss der Locator genau ein Element liefern. Dieses muss\nsichtbar und stabil sein, was bedeutet, dass sein Begrenzungsrechteck in\nmindestens zwei aufeinanderfolgenden Animationsframes gleich bleibt. Es muss\nden Klick empfangen können, statt unter einem anderen Element zu liegen, und\naktiviert sein. Bestehen die Prüfungen nicht innerhalb des Zeitlimits, endet\ndie Aktion mit einem `TimeoutError`. Assertions in der Form\n`await expect(locator)` verhalten sich ebenso: Sie fragen das Element immer\nwieder neu ab, bis die Bedingung gilt oder das Zeitlimit der Assertion von\nstandardmäßig fünf Sekunden abläuft.\n\n## Warum es wichtig ist\n\nPlaywright hilft bei der Entscheidung, welches Verhalten in einem echten\nBrowser geprüft werden muss und wie diese Prüfungen so verlässlich werden,\ndass man einem roten Build glaubt. Manche Fehler entstehen erst, wenn die\nSeite zusammengesetzt ist: ein Dialog, der die Schaltfläche verdeckt, die er\nfreigeben sollte; ein Layout, das ein Feld bei einer bestimmten Breite\nversteckt; ein Skript, das in einer Engine funktioniert und in einer anderen\neinen Fehler wirft. Tests isolierter Codeteile können sie nicht sehen.\n\nBrowsertests werden instabil, wenn Test und Seite um den richtigen Zeitpunkt\nkonkurrieren. Die Seite lädt Daten, animiert und rendert neu. Ein Test, der\nklickt, sobald seine Zeile ausgeführt wird, klickt deshalb manchmal zu früh.\nDie übliche Abhilfe war eine feste Pause: auf einem langsamen Rechner zu kurz,\nauf einem schnellen verschwendete Zeit. Automatisches Warten und wiederholte\nAssertions ersetzen die Pause durch die Bedingung, von der der Test tatsächlich\nabhängt. Der Leitfaden für Assertions sagt es klar: Webseiten zeigen\nInformationen asynchron an, und Assertions, die nur einmal prüfen, führen zu\ninstabilen Tests.\n\nDie zweite Entscheidung betrifft die Suche nach Elementen. Der Leitfaden für\nLocators empfiehlt zuerst Attribute, die Nutzer wahrnehmen, und vor allem\nRollen-Locatoren. `getByRole` mit einem zugänglichen Namen kommt dem am\nnächsten, „wie Nutzer und assistive Technologien die Seite wahrnehmen“. Das hat\neinen nützlichen Nebeneffekt: Ein Test, der die Schaltfläche mit dem Namen\n„Sign in“ anklickt, schlägt fehl, wenn sie ihren Namen verliert. Derselbe\nFehler würde einem Screenreader-Nutzer begegnen. Der Leitfaden sagt aber auch,\ndass Rollen-Locatoren „keine Barrierefreiheits-Audits und Konformitätstests\nersetzen“. Test-IDs sind die Ausweichmöglichkeit. Der Leitfaden nennt sie die\nrobusteste Option und zugleich „nicht an Nutzer gerichtet“. Eine Suite, die\nalles über IDs findet, beweist deshalb weniger über das Erlebnis eines\nBesuchers. CSS- und XPath-Selektoren werden nicht empfohlen, weil sich das DOM\nhäufig ändert.\n\nDer Preis ist Zeit. Einen Browser zu starten und eine Seite zu\nladen macht Browsertests zur langsamsten Testart eines Projekts. Scheitert ein\nsolcher Test auf einem Build-Server, hilft der Trace Viewer bei der\nFehlersuche. Das dokumentierte Konfigurationsbeispiel zeichnet beim ersten\nWiederholungsversuch eines fehlgeschlagenen Tests einen Trace auf. Dabei sind\nzwei Wiederholungen in CI und keine lokal eingestellt. Im Runner selbst sind\nstandardmäßig weder Tracing noch Wiederholungen aktiviert. Mit dem Trace lässt\nsich jede Aktion mit den Seitenzuständen davor und danach, den\nNetzwerkanfragen und der Konsole durchgehen.\n\n## Wie es in der Praxis aussieht\n\nEine Plattform hier hält ihre Geschäftslogik in der Datenbank. Die Aufgabe\nbestand darin,\n[eine gestufte Testsuite über vier Ebenen aufzubauen](/de/portfolio/built-a-test-suite-across-go-sql-and-browser/).\nIhr erklärtes Ziel war, das Verhalten jeder Ebene dort zu prüfen, wo es\nstattfindet, „statt alles von außen durch einen Browser zu prüfen“. Die Go-API\nenthält 981 Testfunktionen. Die Datenbank enthält 494 Dateien mit\nVerhaltenstests. Eine gespeicherte Funktion wird somit in der Datenbank\ngeprüft, statt durch drei darüberliegende Anwendungsebenen. Das Frontend\nenthält 543 Vitest- und Playwright-Specs, darunter 48 End-to-End-Dateien und\n30 Browser-Specs. Die Seite nennt eine gemeinsame Zahl für beide Werkzeuge.\nDie gesamte Suite läuft als 10 Jobs in einem 612 Zeilen langen Workflow.\nDie Seite benennt den Preis offen: Die Suite ist langsam, belastet jede\nÄnderung und braucht bei dieser Größe eigene Wartung.\n\nDiese Website verwendet für ihre eigenen Browserprüfungen eine andere\nBibliothek, Puppeteer. Ihre [Credits-Seite](/de/credits/) zeigt dieselbe\nAbwägung. Die Prüfungen decken ab, was ein Validator nicht erfassen kann,\netwa gemessenen Kontrast, Fokusreihenfolge, Zielgröße, über den Viewport\nhinausragende Inhalte und Seitenumbrüche beim Drucken. Die verbindliche Qualitätsprüfung führt\nvor jedem Push alle außer der Viewport-Überlaufprüfung aus. Diese wartet wie\nder pixelgenaue visuelle Regressionstest darauf, dass jemand sie bei Bedarf\nstartet.\n\n## Wo es schiefgeht\n\nDie meisten Probleme mit Playwright entstehen durch Tests, die weniger prüfen,\nals ihre Namen behaupten.\n\n**Eine feste Pause ersetzt eine Bedingung.** Ein Test wartet zwei Sekunden und\nliest dann die Seite oder liest einen Wert einmalig und vergleicht ihn mit\neiner allgemeinen Assertion. Auf einem ausgelasteten Build-Server sind zwei\nSekunden manchmal zu kurz. Prüfen Sie mit einer auf Webseiten ausgerichteten\nAssertion wie `toHaveText`, was ein Besucher sehen würde, und lassen Sie sie\nerneut prüfen.\n\n**Elemente werden anhand ihres Markups gefunden.** Ein Selektor durch drei\nverschachtelte `div`-Elemente oder eine Gestaltungsklasse scheitert beim\nnächsten Redesign, obwohl die Seite weiterhin funktioniert. Finden Sie das\nElement über Rolle und zugänglichen Namen oder über Beschriftung oder Text.\nErgänzen Sie nur dort eine Test-ID, wo nichts für den Nutzer Wahrnehmbares es\nidentifiziert.\n\n**Ein erfolgreicher Rollen-Locator gilt als Barrierefreiheitsprüfung.**\n`getByRole` beweist, dass ein Element die vom Test verlangte Rolle und den\nverlangten Namen hat. Über Kontrast, Fokusreihenfolge oder den Rest der Seite\nsagt es nichts. Führen Sie dafür im Test eine Regel-Engine wie axe aus, wie es\nPlaywrights eigener\n[Leitfaden](https://playwright.dev/docs/accessibility-testing) über\n`@axe-core/playwright` tut. Der Scan erfasst die Seite „in ihrem aktuellen\nZustand zum Zeitpunkt des Aufrufs“. Öffnen Sie also zuerst das Menü oder den\nDialog.\n\n**Ein Klick wird erzwungen.** Die Option `force` schaltet die nicht wesentlichen\nPrüfungen der Ausführbarkeit ab. Bei einem Klick prüft Playwright dann nicht\nmehr, ob das Ziel das Ereignis tatsächlich empfängt. Ein Test, der das braucht,\numgeht oft etwas, das auch ein Besucher vorfinden würde, etwa ein Banner über\nder Schaltfläche. Behandeln Sie den ursprünglichen Fehler als Befund. Schließen\nSie entweder das Banner so, wie ein Besucher es tun würde, oder beheben Sie die\nÜberlappung.\n\n**Ein instabiler Test wird so oft wiederholt, bis er besteht.** Bei aktivierten\nWiederholungen wird ein Test, der zuerst scheitert und bei einer Wiederholung\nbesteht, als instabil statt als fehlgeschlagen markiert. Ein über Wochen\ninstabiler Test konkurriert entweder mit der Seite um den richtigen Zeitpunkt\noder findet einen echten sporadischen Fehler. Der bei seiner ersten\nWiederholung aufgezeichnete Trace ist der Ausgangspunkt für die Suche.\n\n**Alles wird durch den Browser geprüft.** Eine Regel zu Preisen oder\nBerechtigungen durch Klicks über drei Ansichten zu testen ist langsam und\nscheitert aus Gründen, die nichts mit der Regel zu tun haben. Prüfen Sie die\nRegel dort, wo sie liegt, und behalten Sie Browsertests für das, was nur ein\nBrowser zeigen kann: den Ablauf für den Nutzer, das Layout und die Unterschiede\nzwischen Engines.\n\n## Weiterführende Lektüre\n\n- [Installation](https://playwright.dev/docs/intro) — Playwright Test\n  installieren, Beispieltests ausführen, der HTML-Bericht und UI Mode.\n- [Locators](https://playwright.dev/docs/locators) — die empfohlene Reihenfolge\n  zum Finden von Elementen, von Rolle und Beschriftung bis zu Test-IDs.\n- [Automatisches Warten](https://playwright.dev/docs/actionability) — die\n  Prüfungen der Ausführbarkeit hinter jeder Aktion und was `force` abschaltet.\n- [Assertions](https://playwright.dev/docs/test-assertions) — wiederholende und\n  nicht wiederholende Assertions, das Standardzeitlimit, Soft Assertions und\n  Polling.\n- [Trace Viewer](https://playwright.dev/docs/trace-viewer-intro) — bei einer\n  Wiederholung einen Trace aufzeichnen und einen fehlgeschlagenen Test Aktion\n  für Aktion durchgehen.\n- [Browser](https://playwright.dev/docs/browsers) — die Engines installieren,\n  die Browserdistributionen Chrome und Edge ausführen und die zwei\n  Headless-Modi.\n\n\u003chttps://engineer.company/de/glossary/playwright/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Worauf Playwright Test vor jedem Klick wartet, warum es Elemente nach Rolle und Namen findet und welchen Aufwand Tests in echten Browsern verursachen.","formats":{"gemtext":"https://engineer.company/de/glossary/playwright/index.gmi","gopher":"https://engineer.company/de/glossary/playwright/gophermap","html":"https://engineer.company/de/glossary/playwright/","json":"https://engineer.company/de/glossary/playwright/index.json","markdown":"https://engineer.company/de/glossary/playwright/index.md","pdf":"https://engineer.company/de/glossary/playwright/index.pdf"},"kind":"page","language":"de","title":"Was ist Playwright?","url":"https://engineer.company/de/glossary/playwright/","version":1}