Referência Principal da API

O poder do Puppeteer reside na sua capacidade de simular todos os comportamentos de uma pessoa real através de código. Este capítulo explica várias das APIs mais usadas para ajudar você a dominar rapidamente as operações de página.

1. Navegação de Página

Navegar para um site específico é o primeiro passo da automação.

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

Você pode esperar por diferentes estágios de carregamento da página:

• networkidle0: As solicitações de rede pararam completamente (não mais que 0 conexões por 500ms).
• networkidle2: As solicitações de rede quase pararam (não mais que 2 conexões por 500ms).

2. Interação com Elementos

Clique

Insira um seletor CSS para simular um clique do mouse.

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

Digitar

Simule um teclado para inserir texto.

await page.type('#username', 'minha_conta');

3. Mecanismo de Espera

As páginas da web geralmente carregam dados dinamicamente, por isso devemos esperar que os elementos apareçam antes de operá-los.

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

4. Avaliação (Invocando JS no Lado do Navegador)

Às vezes, precisamos executar código diretamente dentro da janela do navegador para obter informações.

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

---

TIP

Teoria dominada? O próximo capítulo Exemplos do Mundo Real levará você para cenários de negócios reais.