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

test('Manipuler des éléments dans une iframe', async ({ page }) => {
  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

// Obtenir toutes les frames de la page (y compris la frame principale et les iframes)
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

// Iframe imbriquée : externe → interne → élément
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 dialogueComportement 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

test('Gestion personnalisée des boîtes de dialogue', async ({ page }) => {
  // 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éthodeDescription
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

test('Gérer un nouvel onglet', async ({ page }) => {
  // 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

test('Écouter toutes les nouvelles pages dans le contexte', async ({ context, page }) => {
  // É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énementMoment de déclenchement
requestLorsque la page initie une requête réseau
responseLorsqu'une réponse réseau est reçue
dialogLorsqu'une boîte de dialogue alert/confirm/prompt apparaît
downloadLorsqu'un téléchargement de fichier commence
popupLorsqu'une nouvelle page (popup/nouvel onglet) s'ouvre
consoleLorsque la page affiche un message dans la console
pageerrorLorsqu'une erreur JavaScript non interceptée se produit sur la page
loadLorsque la page a fini de charger
closeLorsque la page se ferme

Méthodes d'écoute d'événements

Exemple

// Écouter en continu
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);
Autres extensions