Playwright Frame et nouvelles fenêtres
Ce chapitre présente comment gérer les iframes, les boîtes de dialogue, les nouveaux onglets et le système d'événements de Playwright.
Opérations sur les iframes
Playwright utiliseframeLocator()pour localiser et manipuler des éléments dans les iframes.
page.frameLocator() pour localiser les iframes
Exemple
await page.goto('https://www.example.com/iframe-demo');
// Localiser l'iframe, puis localiser l'élément à l'intérieur
const iframe = page.frameLocator('#my-iframe');
// Manipuler l'élément à l'intérieur de l'iframe
await iframe.getByRole('button', { name: 'Submit' }).click();
await iframe.getByLabel('Username').fill('example_user');
// Vérifier à l'intérieur de l'iframe
await expect(iframe.getByText('Operation successful')).toBeVisible();
});
Obtenir toutes les frames
Exemple
const frames = page.frames();
console.log('La page a ', frames.length, ' cadres');
frames.forEach(frame => {
console.log('Cadre :', frame.name(), frame.url());
});
Iframes imbriquées
PlaywrightframeLocator()prend en charge les appels chaînés, permettant un accès profond aux iframes imbriquées.
Exemple
const innerButton = page
.frameLocator('#outer-frame')
.frameLocator('#inner-frame')
.getByRole('button', { name: 'Confirmer' });
await innerButton.click();
Gestion des boîtes de dialogue
Playwright dispose d'une stratégie de gestion par défaut pour les boîtes de dialogue natives du navigateur (alert, confirm, prompt).
Comportement par défaut
Playwright par défautrejette automatiquementtoutes les boîtes de dialogue :
| Type de boîte de dialogue | Comportement par défaut |
|---|---|
alert() | Rejeter automatiquement (fermer) |
confirm() | Accepter automatiquement (renvoie true) |
prompt() | Accepter automatiquement (renvoie une chaîne vide) |
Gestion personnalisée des boîtes de dialogue
Utilisationpage.on('dialog')vous pouvez intercepter et personnaliser la gestion des boîtes de dialogue.
Exemple
// Enregistrer un écouteur avant de déclencher la boîte de dialogue
page.on('dialog', async dialog => {
console.log('Type de boîte de dialogue :', dialog.type());
console.log('Message de la boîte de dialogue :', dialog.message());
if (dialog.type() === 'confirm') {
// Annuler la boîte de dialogue de confirmation
await dialog.dismiss();
} else if (dialog.type() === 'prompt') {
// Saisir un contenu personnalisé
await dialog.accept('Contenu saisi par EXAMPLE');
} else {
// Pour les autres types, accepter simplement
await dialog.accept();
}
});
// L'opération qui déclenche la boîte de dialogue
await page.getByRole('button', { name: 'Delete' }).click();
});
Méthodes de l'objet Dialog
| Méthode | Description |
|---|---|
dialog.accept(promptText?) | Accepter la boîte de dialogue (peut transmettre un texte de saisie pour prompt) |
dialog.dismiss() | Rejeter la boîte de dialogue |
dialog.message() | Obtenir le message de la boîte de dialogue |
dialog.type() | Obtenir le type de la boîte de dialogue :'alert' | 'confirm' | 'prompt' | 'beforeunload' |
Nouvelles fenêtres et nouveaux onglets
Lorsqu'un clic sur un lien ou un bouton ouvre un nouvel onglet, Playwright propose plusieurs façons d'obtenir la nouvelle page.
page.waitForEvent('popup') pour attendre le popup
Exemple
// Préparer l'attente de l'événement de nouvelle page avant de cliquer
const popupPromise = page.waitForEvent('popup');
// Cliquer sur le lien qui ouvre une nouvelle fenêtre
await page.getByRole('link', { name: 'Ouvrir une nouvelle fenêtre' }).click();
// Récupérer la page nouvellement ouverte
const popup = await popupPromise;
// Effectuer des opérations sur la nouvelle page
await expect(popup).toHaveTitle(/EXAMPLE/);
await popup.getByRole('button', { name: 'OK' }).click();
// Fermer la nouvelle page
await popup.close();
});
context.on('page') pour écouter les nouvelles pages
Exemple
// Écouter la création de nouvelles pages dans tout le contexte
context.on('page', async newPage => {
console.log('Une nouvelle page ouverte :', newPage.url());
// Attendre que la nouvelle page ait fini de charger
await newPage.waitForLoadState();
// Effectuer des opérations sur la nouvelle page
});
await page.goto('https://www.example.com/');
// Les opérations suivantes qui ouvrent de nouvelles fenêtres déclencheront automatiquement l'écouteur ci-dessus
});
Système d'événements Playwright
Les objets Page et Context de Playwright sont des émetteurs d'événements, et vous pouvez écouter divers événements.
Événements de page courants
| Événement | Moment de déclenchement |
|---|---|
request | Lorsque la page initie une requête réseau |
response | Lorsqu'une réponse réseau est reçue |
dialog | Lorsqu'une boîte de dialogue alert/confirm/prompt apparaît |
download | Lorsqu'un téléchargement de fichier commence |
popup | Lorsqu'une nouvelle page (popup/nouvel onglet) s'ouvre |
console | Lorsque la page affiche un message dans la console |
pageerror | Lorsqu'une erreur JavaScript non interceptée se produit sur la page |
load | Lorsque la page a fini de charger |
close | Lorsque la page se ferme |
Méthodes d'écoute d'événements
Exemple
page.on('request', request => {
console.log('Request:', request.method(), request.url());
});
// Écouter une fois (supprimé automatiquement après avoir été déclenché une fois)
page.once('dialog', dialog => {
dialog.accept();
});
// Supprimer l'écouteur
const handler = (request) => { /* ... */ };
page.on('request', handler);
page.off('request', handler);