API des classes principales de Playwright
Cette annexe répertorie les API courantes des classes principales de Playwright pour une référence rapide.
Classe Playwright
Playwright est l'objet d'entrée de la bibliothèque Playwright.
| Méthodes/Propriétés | Description |
|---|---|
playwright.chromium | Retourne l'objet BrowserType pour Chromium |
playwright.firefox | Retourne l'objet BrowserType pour Firefox |
playwright.webkit | Retourne l'objet BrowserType pour WebKit |
playwright.request | Retourne l'objet APIRequest |
playwright.selectors | Renvoie l'objet Selectors |
Classe BrowserType
BrowserType est utilisé pour lancer des navigateurs et s'y connecter.
| Méthodes | Description |
|---|---|
browserType.launch(options?) | Lance une instance de navigateur |
browserType.launchPersistentContext(userDataDir, options?) | Lance un contexte persistant (à l'aide d'un répertoire local de données utilisateur) |
browserType.connect(url, options?) | Se connecte à un navigateur déjà en cours d'exécution |
browserType.connectOverCDP(url, options?) | Se connecte à un navigateur déjà en cours d'exécution via le protocole CDP |
browserType.executablePath() | Renvoie le chemin de l'exécutable du navigateur |
browserType.name() | Renvoie le nom du navigateur |
Classe Browser
Browser représente une instance de navigateur.
| Méthodes/Propriétés | Description |
|---|---|
browser.newContext(options?) | Crée un nouveau BrowserContext |
browser.newPage(options?) | Crée une nouvelle Page dans un nouveau Context |
browser.contexts() | Renvoie une liste de tous les Contexts |
browser.close() | Ferme le navigateur et toutes les pages |
browser.browserType() | Renvoie le BrowserType correspondant |
browser.version() | Renvoie la version du navigateur |
browser.isConnected() | Indique si connecté |
Classe BrowserContext
BrowserContext représente un contexte de navigateur indépendant.
| Méthodes | Description |
|---|---|
context.newPage() | Crée une nouvelle page |
context.pages() | Renvoie toutes les pages ouvertes |
context.close() | Ferme le Context |
context.cookies(urls?) | Récupère les cookies |
context.addCookies(cookies) | Ajoute des cookies |
context.clearCookies() | Efface tous les cookies |
context.storageState(options?) | Récupère l’état de stockage actuel (pour la réutilisation de l’authentification) |
context.grantPermissions(permissions) | Accorde des autorisations |
context.clearPermissions() | Efface les autorisations |
context.setGeolocation(geolocation) | Définit la géolocalisation |
context.setExtraHTTPHeaders(headers) | Définit des en-têtes HTTP supplémentaires |
context.route(url, handler) | Intercepte les requêtes réseau |
context.unroute(url, handler?) | Annule l’interception |
context.exposeFunction(name, fn) | Expose une fonction à la page |
context.exposeBinding(name, callback) | Expose une liaison à la page |
Classe BrowserServer
BrowserServer représente le processus de navigateur lancé vialaunchServer()le processus de navigateur lancé.
| Méthodes | Description |
|---|---|
browserServer.wsEndpoint() | Renvoie l'URL du point de terminaison WebSocket (pour la connexion à distance) |
browserServer.close() | Ferme le serveur et le navigateur |
browserServer.kill() | Met fin de force au processus de navigateur |