Skip to content

Référence API de base

La puissance de Puppeteer réside dans sa capacité à simuler tous les comportements d'une personne réelle via le code. Ce chapitre explique plusieurs des API les plus couramment utilisées pour vous aider à maîtriser rapidement les opérations de page.

1. Navigation dans les pages

Naviguer vers un site Web spécifié est la première étape de l'automatisation.

javascript
await page.goto('https://www.google.com');

Vous pouvez attendre différentes étapes du chargement de la page :

  • networkidle0 : Les requêtes réseau sont complètement arrêtées (pas plus de 0 connexion pendant 500 ms).
  • networkidle2 : Les requêtes réseau sont presque arrêtées (pas plus de 2 connexions pendant 500 ms).

2. Interaction avec les éléments

Clic

Entrez un sélecteur CSS pour simuler un clic de souris.

javascript
await page.click('#login-button');

Saisie

Simulez un clavier pour saisir du texte.

javascript
await page.type('#username', 'mon_compte');

3. Mécanisme d'attente

Les pages Web chargent souvent des données de manière dynamique, nous devons donc attendre que les éléments apparaissent avant de les manipuler.

javascript
await page.waitForSelector('.success-message');

4. Évaluation (Invoquer du JS côté navigateur)

Parfois, nous devons exécuter du code directement dans la fenêtre du navigateur pour obtenir des informations.

javascript
const title = await page.evaluate(() => {
  return document.title;
});

TIP

Théorie maîtrisée ? Le chapitre suivant Exemples concrets vous plongera dans des scénarios commerciaux réels.