Playwright-Kernklassen-API
Dieser Anhang listet die gängigen APIs der Playwright-Kernklassen zum schnellen Nachschlagen auf.
Playwright-Klasse
Playwright ist das Einstiegsobjekt der Playwright-Bibliothek.
| Methoden/Eigenschaften | Beschreibung |
|---|---|
playwright.chromium | Gibt das BrowserType-Objekt für Chromium zurück |
playwright.firefox | Gibt das BrowserType-Objekt für Firefox zurück |
playwright.webkit | Gibt das BrowserType-Objekt für WebKit zurück |
playwright.request | Gibt das APIRequest-Objekt zurück |
playwright.selectors | Gibt das Selectors-Objekt zurück |
BrowserType-Klasse
BrowserType wird verwendet, um Browser zu starten und sich mit ihnen zu verbinden.
| Methoden | Beschreibung |
|---|---|
browserType.launch(options?) | Startet eine Browser-Instanz |
browserType.launchPersistentContext(userDataDir, options?) | Startet einen persistenten Kontext (unter Verwendung eines lokalen Benutzerdatenverzeichnisses) |
browserType.connect(url, options?) | Verbindet sich mit einem bereits laufenden Browser |
browserType.connectOverCDP(url, options?) | Verbindet sich über das CDP-Protokoll mit einem bereits laufenden Browser |
browserType.executablePath() | Gibt den Pfad zur ausführbaren Browserdatei zurück |
browserType.name() | Gibt den Browser-Namen zurück |
Browser-Klasse
Browser repräsentiert eine Browser-Instanz.
| Methoden/Eigenschaften | Beschreibung |
|---|---|
browser.newContext(options?) | Erstellt einen neuen BrowserContext |
browser.newPage(options?) | Erstellt eine neue Page in einem neuen Context |
browser.contexts() | Gibt eine Liste aller Kontexte zurück |
browser.close() | Schließt den Browser und alle Seiten |
browser.browserType() | Gibt den entsprechenden BrowserType zurück |
browser.version() | Gibt die Browserversion zurück |
browser.isConnected() | Gibt an, ob verbunden |
BrowserContext-Klasse
BrowserContext repräsentiert einen unabhängigen Browserkontext.
| Methoden | Beschreibung |
|---|---|
context.newPage() | Erstellt eine neue Seite |
context.pages() | Gibt alle geöffneten Seiten zurück |
context.close() | Schließt den Context |
context.cookies(urls?) | Ruft Cookies ab |
context.addCookies(cookies) | Fügt Cookies hinzu |
context.clearCookies() | Löscht alle Cookies |
context.storageState(options?) | Ruft den aktuellen Speicherzustand ab (zur Wiederverwendung der Authentifizierung) |
context.grantPermissions(permissions) | Erteilt Berechtigungen |
context.clearPermissions() | Löscht Berechtigungen |
context.setGeolocation(geolocation) | Legt Geolokalisierung fest |
context.setExtraHTTPHeaders(headers) | Legt zusätzliche HTTP-Header fest |
context.route(url, handler) | Fängt Netzwerkanfragen ab |
context.unroute(url, handler?) | Bricht die Abfangung ab |
context.exposeFunction(name, fn) | Stellt eine Funktion für die Seite bereit |
context.exposeBinding(name, callback) | Stellt eine Bindung für die Seite bereit |
BrowserServer-Klasse
BrowserServer repräsentiert den Browserprozess, der gestartet wurde überlaunchServer()der gestartete Browserprozess.
| Methoden | Beschreibung |
|---|---|
browserServer.wsEndpoint() | Gibt die WebSocket-Endpunkt-URL zurück (für Remote-Verbindung) |
browserServer.close() | Schließt den Server und den Browser |
browserServer.kill() | Beendet den Browserprozess gewaltsam |