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ésDescription
playwright.chromiumRetourne l'objet BrowserType pour Chromium
playwright.firefoxRetourne l'objet BrowserType pour Firefox
playwright.webkitRetourne l'objet BrowserType pour WebKit
playwright.requestRetourne l'objet APIRequest
playwright.selectorsRenvoie l'objet Selectors

Classe BrowserType

BrowserType est utilisé pour lancer des navigateurs et s'y connecter.

MéthodesDescription
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ésDescription
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éthodesDescription
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éthodesDescription
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
Autres extensions