Tutoriel Playwright

API des classes principales Playwright

API de la classe Locator de Playwright

Référence de l'API de la classe Page de Playwright

Page est la classe la plus couramment utilisée dans Playwright, fournissant toutes les méthodes d'interaction avec la page.

Méthodes de navigation

Méthode	Description
`page.goto(url, options?)`	Naviguer vers l'URL
`page.goBack(options?)`	Revenir en arrière
`page.goForward(options?)`	Avancer
`page.reload(options?)`	Recharger la page

Méthodes de localisation

Méthode	Description
`page.getByRole(role, options?)`	Localiser par rôle ARIA
`page.getByText(text, options?)`	Localiser par contenu textuel
`page.getByLabel(text, options?)`	Localiser par étiquette associée
`page.getByPlaceholder(text)`	Localiser par placeholder
`page.getByAltText(text)`	Localiser par l'attribut alt de l'image
`page.getByTitle(text)`	Localiser par l'attribut title
`page.getByTestId(id)`	Localiser par data-testid
`page.locator(selector)`	Localisateur CSS / XPath
`page.frameLocator(selector)`	Localisateur d'iframe

Récupération des propriétés de la page

Méthode	Description
`page.title()`	Obtenir le titre de la page
`page.url()`	Obtenir l'URL actuelle
`page.content()`	Obtenir le contenu HTML complet
`page.viewportSize()`	Obtenir la taille de la fenêtre d'affichage

Captures d'écran et PDF

Méthode	Description
`page.screenshot(options?)`	Capture d'écran de page
`page.pdf(options?)`	Générer un PDF (Chromium uniquement)
`page.video()`	Obtenir l'objet vidéo

Clavier et souris

Propriété	Description
`page.keyboard`	Objet clavier
`page.mouse`	Objet souris
`page.touchscreen`	Objet écran tactile

Exécution JS

Méthode	Description
`page.evaluate(fn, arg?)`	Exécuter du JS dans le contexte de la page
`page.evaluateHandle(fn, arg?)`	Exécuter JS et renvoyer JSHandle
`page.addInitScript(script)`	Injecter le script d'initialisation
`page.addStyleTag(options?)`	Ajouter une balise de style
`page.addScriptTag(options?)`	Ajouter une balise script
`page.exposeFunction(name, fn)`	Exposer une fonction à la page

Méthodes d'attente

Méthode	Description
`page.waitForURL(url, options?)`	Attendre le changement d'URL
`page.waitForLoadState(state?)`	Attendre l'état de chargement
`page.waitForTimeout(ms)`	Attente fixe
`page.waitForEvent(event, options?)`	Attendre un événement
`page.waitForResponse(urlOrPredicate, options?)`	Attendre une réponse réseau
`page.waitForRequest(urlOrPredicate, options?)`	Attendre une requête réseau

Réseau et routage

Méthode	Description
`page.route(url, handler)`	Intercepter les requêtes réseau
`page.unroute(url, handler?)`	Annuler l'interception
`page.routeFromHAR(har, options?)`	Rejouer le réseau à partir d'un fichier HAR

Événements

Événement	Description
`page.on('request', handler)`	Écouter les requêtes
`page.on('response', handler)`	Écouter les réponses
`page.on('dialog', handler)`	Écouter les popups
`page.on('download', handler)`	Écouter les téléchargements
`page.on('popup', handler)`	Écouter la page popup
`page.on('console', handler)`	Écouter la console
`page.on('pageerror', handler)`	Écouter les erreurs de page
`page.on('close', handler)`	Écouter la fermeture de page

Lié aux frames

Méthode	Description
`page.mainFrame()`	Obtenir la frame principale
`page.frames()`	Obtenir toutes les frames

Autres

Méthode	Description
`page.context()`	Obtenir le BrowserContext propriétaire
`page.close()`	Fermer la page
`page.pause()`	Suspendre l'exécution (pour le débogage)
`page.setViewportSize(size)`	Définir la taille du viewport
`page.bringToFront()`	Mettre la page au premier plan
`page.emulateMedia(options?)`	Émuler les fonctionnalités média
`page.clock`	Objet Clock (simulation du temps)

PageAssertions (assertions avec réessai automatique)

Méthodes d'assertion	Description
`expect(page).toHaveTitle(title)`	Assertion sur le titre de la page
`expect(page).toHaveURL(url)`	Assertion sur l'URL de la page
`expect(page).toHaveScreenshot(options?)`	Comparaison de captures d'écran de page

Autres extensions

API des classes principales Playwright

API de la classe Locator de Playwright