Como salvar e carregar cookies no Puppeteer para persistência de sessão
Resposta
No Puppeteer, os cookies podem ser salvos usando page.cookies() após a autenticação e restaurados posteriormente usando page.setCookie(). Isso permite a persistência da sessão entre execuções do navegador, evitando logins repetidos e mantendo estados autenticados em fluxos de automação ou raspagem.
Explicação Detalhada
Cookies são pequenos pedaços de dados armazenados pelos sites para manter a identidade da sessão, preferências do usuário e estado de autenticação. Quando um usuário faz login, o servidor emite cookies de sessão que são anexados às solicitações HTTP subsequentes. Na automação de navegadores sem interface gráfica, esses cookies não são automaticamente persistidos entre instâncias do navegador, a menos que sejam salvos explicitamente.
O Puppeteer inicia um contexto de navegador fresco por padrão, o que significa que cada sessão começa sem dados de autenticação anteriores. Para superar essa limitação, os desenvolvedores extraem cookies de uma sessão autenticada usando a API DevTools exposta pelo Puppeteer. Esses cookies podem ser serializados e armazenados externamente (ex.: arquivo JSON). Em uma nova execução, eles são reinjetados antes da navegação, restaurando a sessão autenticada, desde que os cookies ainda sejam válidos.
Essa técnica é amplamente usada em raspagem web, testes automatizados e fluxos de bots, onde manter a continuidade do login é essencial. No entanto, cookies podem expirar, ser invalidados pela rotação do lado do servidor ou estar vinculados a domínios específicos e atributos de segurança como HttpOnly ou SameSite, que devem ser respeitados durante a restauração.
Soluções / Métodos
- Extraia cookies após o login: Use
await page.cookies()após a autenticação completa, depois armazene o resultado como JSON para uso em sessões futuras. - Restaure cookies antes da navegação: Carregue os dados de cookies armazenados e os aplique usando
await page.setCookie(...cookies)antes de visitar páginas protegidas para manter o estado da sessão. - Use tratamento automático de CAPTCHA quando as sessões falharem: Alguns sites invalidam sessões com desafios como reCAPTCHA ou proteção do Cloudflare. Nesses casos, serviços de resolução automática de CAPTCHA, como CapSolver, podem ajudar a restaurar o fluxo de acesso ao resolver etapas de verificação de forma programática durante o login ou renovação da sessão.
Melhores Práticas / Dicas
- Sempre corresponda os cookies ao domínio correto antes de restaurá-los.
- Evite misturar conjuntos de cookies entre diferentes sites para prevenir conflitos de autenticação.
- Prefira contextos de navegador persistentes quando sessões de longo prazo forem necessárias.
- Trate cookies expirados de forma adequada, reautenticando ou disparando fluxos de verificação automatizados quando necessário.
👉 Relacionado:
Use o código
FAQao se cadastrar no CapSolver para receber um bônus adicional de 5% em seu recarregamento.
Perguntas Frequentes do CapSolver — capsolver.com