Guias
Um guia por recurso, cada um com exemplos executáveis. Comece por Conceitos centrais se você está começando, ou vá direto para a tarefa que precisa.
Conceitos centrais
- Conceitos centrais: os objetos tab e browser, o modelo assíncrono, e o que "sem webdriver" significa na prática.
Encontrando e extraindo
- Encontrar elementos: localize elementos com
find()(por atributos) equery()(CSS ou XPath). - Navegação no DOM: vá de um elemento para seus filhos, irmãos e shadow roots.
- Extração estruturada: obtenha dados tipados e validados de uma página com um modelo.
Interagindo
- Teclado: digite texto e pressione teclas, com timing humanizado.
- Mouse: clique em elementos ou controle coordenadas brutas, com movimento humanizado.
- Operações com arquivos: envie arquivos e lide com downloads.
- Iframes: encontre e controle elementos dentro de frames.
- Screenshots e PDFs: capture a página, um elemento ou um PDF.
Rede
- Monitoramento de rede: observe requisições e respostas conforme acontecem.
- Interceptação de requisições: bloqueie, modifique ou simule requisições.
- Requisições HTTP no contexto do navegador: chame APIs a partir da sessão do navegador, com seus cookies e autenticação.
- Gravação de HAR: grave uma sessão em um arquivo HAR.
Gerenciando o navegador
- Abas: abra, feche e controle várias abas ao mesmo tempo.
- Contextos de navegador: sessões isoladas em um só navegador, cada uma com seus próprios cookies.
- Cookies e sessões: leia, defina e persista cookies entre execuções.
- Opções do navegador: flags de linha de comando, headless e a configuração de inicialização.
- Preferências do navegador: o dicionário interno de preferências do Chromium.
- Proxies: roteie o tráfego por um proxy, com autenticação.
- Conexões remotas: conecte-se a um navegador que já está em execução.
Reagindo a eventos
- Eventos: execute callbacks quando eventos de página e de rede disparam.
- Repetição: repita passos instáveis com o decorador
retry.
Próximos passos
- Ficando indetectável: comportamento humanizado, tratamento de captcha e fingerprinting.
- Referência da API: cada classe e método público.