Playwright-API-Referenz für die Page-Klasse
Page ist die am häufigsten verwendete Klasse in Playwright und bietet alle Methoden für die Seiteninteraktion.
Navigationsmethoden
| Methode | Beschreibung |
|---|
page.goto(url, options?) | Zu URL navigieren |
page.goBack(options?) | Zurück |
page.goForward(options?) | Vorwärts |
page.reload(options?) | Seite neu laden |
Locator-Methoden
| Methode | Beschreibung |
|---|
page.getByRole(role, options?) | Nach ARIA-Rolle lokalisieren |
page.getByText(text, options?) | Nach Textinhalt lokalisieren |
page.getByLabel(text, options?) | Nach zugeordnetem Label lokalisieren |
page.getByPlaceholder(text) | Nach Platzhalter lokalisieren |
page.getByAltText(text) | Bild anhand des alt-Attributs lokalisieren |
page.getByTitle(text) | Nach title-Attribut lokalisieren |
page.getByTestId(id) | Nach data-testid lokalisieren |
page.locator(selector) | CSS-/XPath-Locator |
page.frameLocator(selector) | iframe-Locator |
Abruf von Seiteneigenschaften
| Methode | Beschreibung |
|---|
page.title() | Seitentitel abrufen |
page.url() | Aktuelle URL abrufen |
page.content() | Vollständigen HTML-Inhalt abrufen |
page.viewportSize() | Viewport-Größe abrufen |
Screenshots und PDF
| Methode | Beschreibung |
|---|
page.screenshot(options?) | Seiten-Screenshot |
page.pdf(options?) | PDF generieren (nur Chromium) |
page.video() | Videoobjekt abrufen |
Keyboard und Mouse
| Eigenschaft | Beschreibung |
|---|
page.keyboard | Keyboard-Objekt |
page.mouse | Mouse-Objekt |
page.touchscreen | Touchscreen-Objekt |
JS-Ausführung
| Methode | Beschreibung |
|---|
page.evaluate(fn, arg?) | JS im Seitenkontext ausführen |
page.evaluateHandle(fn, arg?) | JS ausführen und JSHandle zurückgeben |
page.addInitScript(script) | Initialisierungsskript injizieren |
page.addStyleTag(options?) | Style-Tag hinzufügen |
page.addScriptTag(options?) | Script-Tag hinzufügen |
page.exposeFunction(name, fn) | Funktion für die Seite verfügbar machen |
Wartemethoden
| Methode | Beschreibung |
|---|
page.waitForURL(url, options?) | Auf URL-Änderung warten |
page.waitForLoadState(state?) | Auf Ladezustand warten |
page.waitForTimeout(ms) | Feste Wartezeit |
page.waitForEvent(event, options?) | Auf Ereignis warten |
page.waitForResponse(urlOrPredicate, options?) | Auf Netzwerkantwort warten |
page.waitForRequest(urlOrPredicate, options?) | Auf Netzwerkanfrage warten |
Netzwerk und Routing
| Methode | Beschreibung |
|---|
page.route(url, handler) | Netzwerkanfragen abfangen |
page.unroute(url, handler?) | Abfangen abbrechen |
page.routeFromHAR(har, options?) | Netzwerk aus HAR-Datei wiedergeben |
Ereignisse
| Ereignis | Beschreibung |
|---|
page.on('request', handler) | Auf Anfrage lauschen |
page.on('response', handler) | Auf Antwort lauschen |
page.on('dialog', handler) | Auf Popup lauschen |
page.on('download', handler) | Auf Download lauschen |
page.on('popup', handler) | Auf Popup-Seite lauschen |
page.on('console', handler) | Auf Konsole lauschen |
page.on('pageerror', handler) | Auf Seitenfehler lauschen |
page.on('close', handler) | Auf das Schließen der Seite lauschen |
Frame-bezogen
| Methode | Beschreibung |
|---|
page.mainFrame() | Hauptframe abrufen |
page.frames() | Alle Frames abrufen |
Andere
| Methode | Beschreibung |
|---|
page.context() | Zugehörigen BrowserContext abrufen |
page.close() | Seite schließen |
page.pause() | Ausführung anhalten (zum Debuggen) |
page.setViewportSize(size) | Viewport-Größe festlegen |
page.bringToFront() | Seite in den Vordergrund bringen |
page.emulateMedia(options?) | Medienmerkmale emulieren |
page.clock | Clock-Objekt (Zeitsimulation) |
PageAssertions (automatisch wiederholende Assertions)
| Assertion-Methoden | Beschreibung |
|---|
expect(page).toHaveTitle(title) | Seitentitel-Assertion |
expect(page).toHaveURL(url) | Seiten-URL-Assertion |
expect(page).toHaveScreenshot(options?) | Seiten-Screenshot-Vergleich |
Weitere Erweiterungen