Browserbase ou Browserless: como passar adiante logins, sessões e arquivos após a desconexão de um download de relatório

O Browserbase atende tarefas sequenciais centradas na transferência gerenciada de arquivos e na investigação de falhas. O Browserless oferece caminhos distintos para reconexões breves, sessões persistentes e cópias do estado de autenticação. A escolha deve testar recuperação de desconexões, autenticação expirada e exportações repetidas, sem confundir login salvo ou reprodução de sessão com execução retomável.

Fonte: docs.browserbase.com
November 16, 2026
8 min

Uma pessoa da equipe de operações exporta um relatório diário de um portal de fornecedores que tem autorização para acessar. O script se desconecta logo após clicar em “Gerar relatório”. Quem assume precisa saber: é possível reconectar à página original? Amanhã será preciso entrar novamente? O arquivo foi realmente baixado? Browserbase e Browserless oferecem infraestrutura de navegadores remotos, mas essas perguntas tratam de coisas diferentes: uma sessão em execução, dados persistentes de autenticação e o registro da tarefa de negócio.

Avalie primeiro o Browserbase se quiser reunir Contexts, downloads na nuvem e investigação visual em um fluxo gerenciado. Se já usa Puppeteer ou Playwright e precisa escolher explicitamente entre reconexões breves, estado entre execuções e cópias independentes da autenticação, o Browserless oferece caminhos mais específicos, mas exige distinguir as interfaces. Este artigo se baseia na documentação oficial. Trata apenas de downloads comuns de relatórios em portais próprios ou autorizados, sem contornar restrições de acesso nem resolver CAPTCHAs automaticamente. Não foram realizados testes reais de login ou download.

O que salvar para executar novamente amanhã

Os Contexts do Browserbase preservam dados de login e da aplicação do diretório de dados do usuário do Chromium, incluindo cookies, localStorage e IndexedDB. Uma nova sessão precisa receber o Context ID. Para gravar alterações, configure persist: true na criação. Os dados são salvos quando a sessão termina, e é preciso esperar alguns segundos pela sincronização antes de reutilizá-los. A documentação recomenda um Context separado por login e por site, evitando o uso simultâneo do mesmo Context, que pode causar logout.

O registro da passagem de trabalho deve, portanto, separar Context ID de session ID: o primeiro permite a um novo navegador carregar os dados salvos; o segundo identifica uma execução. O objeto BrowserContext de um framework, os dados persistentes e um navegador em execução são coisas diferentes. A existência do Context não garante uma autenticação válida: o portal pode expirar cookies, revogar tokens ou exigir nova autenticação. Passar pela MFA uma vez não significa ficar permanentemente dispensado dela.

A Session API da documentação atual v2 do Browserless permite preservar cookies, localStorage e cache após reiniciar o navegador. ttl controla a duração dos dados. Com o padrão processKeepAlive: 0, uma nova conexão após a desconexão inicia outro processo em uma página em branco, exigindo nova navegação. Páginas abertas e outros estados em memória só são preservados durante um período de tolerância enquanto o processo continua ativo; esse recurso de manutenção do processo é exclusivo do Puppeteer. Uma sessão persistente admite apenas um cliente conectado por vez, não devendo ser tratada como uma área de trabalho compartilhada por várias pessoas.

Outra opção são os Authenticated Profiles: salvar uma cópia de cookies, localStorage e IndexedDB e carregar uma cópia independente em cada sessão. SessionStorage fica de fora. Alterações durante a execução não atualizam automaticamente o profile original. Isso atende várias tarefas autorizadas que reutilizam um ponto de partida autenticado, em vez de compartilhar a mesma página de relatório. Defina antes quem atualizará a cópia após renovar a autenticação.

Qual navegador precisa continuar ativo para uma volta em poucos minutos?

O keepAlive do Browserbase mantém a mesma sessão disponível para reconexão após a desconexão e só está disponível em planos pagos. Libere-a explicitamente ao concluir o trabalho; caso contrário, ela continua até o timeout e gera uso de navegador ocioso. O recurso atende passagens breves de trabalho, sem substituir a persistência de Contexts entre sessões.

As Standard Sessions do Browserless exigem obter um endpoint de reconexão antes de desconectar. A documentação específica atual limita esse caminho ao Puppeteer. A janela de espera também fica limitada à duração máxima de sessão do plano, contada desde o início original; reconexões repetidas não a estendem indefinidamente. Cada reconexão é cobrada como uma nova conexão, e o navegador em espera continua ocupando uma vaga de simultaneidade. Equipes com Playwright devem projetar o fluxo conforme a documentação de estado persistente, sem copiar a semântica de desconexão do Puppeteer.

O planejamento também precisa distinguir uma pessoa esperando pelo navegador de um navegador esperando por uma pessoa. É possível manter uma sessão breve enquanto o relatório é gerado. Se o trabalho ficar para o dia seguinte, priorize salvar os dados necessários e os pontos de controle do processo de negócio. Caso contrário, conexões ociosas consomem recursos e a próxima pessoa pode receber um endereço já expirado. O agendador de tarefas deve registrar a validade e as responsabilidades de limpeza; uma captura da reprodução não faz esse trabalho.

Isso define a divisão de responsabilidades entre os scripts dos dois turnos. Uma breve interrupção de rede pode permitir reconectar a uma sessão ainda válida. Se o navegador já terminou, leia o ponto de controle e reabra a lista de relatórios, em vez de clicar cegamente em “Gerar” outra vez. Nenhum dos provedores garante execução exatamente uma vez no sistema de negócio apenas pela reconexão do navegador.

A reprodução explica falhas; o arquivo é a entrega

A documentação de downloads do Browserbase informa que os arquivos ficam na nuvem e são recuperados pela API, com um timestamp acrescentado ao nome para reduzir conflitos. Registrar um clique não basta: confira a data do relatório, o tamanho e o conteúdo do arquivo recuperado. A documentação de transferência de arquivos do Browserless oferece um caminho CDP que envia os bytes após habilitar os eventos de download e mostra Download.saveAs em uma conexão nativa do Playwright. Registre os listeners antes de iniciar o download. Ao escolher o método de conexão, defina como os arquivos chegarão ao armazenamento da equipe.

A reprodução de sessões atual do Browserbase permite reprodução HLS por aba e oferece acesso ao download das gravações. O Session Replay do Browserless é habilitado com replay=true e registra mudanças no DOM e outros eventos, ao contrário da gravação de tela que retorna WebM. Ambos ajudam a identificar uma data selecionada incorretamente ou uma etapa travada. Assistir à gravação, porém, não restaura um processo encerrado nem recupera automaticamente um download ausente.

Na passagem de trabalho, associe o identificador da tarefa, o escopo do relatório, o estado da exportação, os resultados da verificação do arquivo e o registro da sessão. As reproduções podem conter informações das páginas de negócio, e os dados de autenticação podem permitir acesso à conta. Limite acesso e retenção, e não cole endereços de conexão com tokens em chamados comuns.

Valide a passagem de trabalho antes de escolher a implantação

Considere um teste de aceitação hipotético: baixar relatórios diários de 3 dias consecutivos com a mesma conta autorizada. No primeiro dia, interrompa após clicar em “Gerar”; o script que assume verifica primeiro o histórico de exportações do portal. No segundo, encerre o navegador e recarregue os dados persistentes, confirme a conta correta e navegue novamente. No terceiro, invalide deliberadamente a autenticação e confirme que a tarefa pausa para o titular da conta se autenticar, em vez de repetir tentativas indefinidamente. Em todos os dias, confira a data do arquivo, o conteúdo não vazio e o identificador da tarefa; use os registros de exportação existentes e a verificação dos arquivos para eliminar duplicações nas reexecuções. Trata-se de um projeto de teste de aceitação, não de um teste de confiabilidade concluído.

Separe também a camada de automação da infraestrutura. O Stagehand oferece ações em linguagem natural, extração e interfaces de controle programático. Ele não corresponde ao serviço Browserbase inteiro, e adotá-lo não resolve automaticamente a responsabilidade por sessões, arquivos e reexecuções. Um script de download com seletores estáveis não precisa virar um agente de IA só para usar um navegador na nuvem.

A documentação de hospedagem própria do Browserless distingue a imagem Docker básica dos recursos Enterprise. Não presuma que reprodução na nuvem, BrowserQL e outros recursos estejam todos incluídos na imagem gratuita. A LICENSE do repositório oferece SSPL ou licença comercial e destaca explicitamente a necessidade de licença comercial para aplicações comerciais de código fechado e integração contínua. A avaliação de hospedagem própria deve incluir atualizações do navegador, capacidade, armazenamento e manutenção de segurança, em vez de comparar a conta da nuvem apenas com o preço de um servidor.

Em resumo, equipes que baixam sequencialmente com uma única conta e priorizam a transferência gerenciada de arquivos e a investigação de falhas podem validar primeiro o Browserbase. Equipes que reutilizam clientes existentes, distinguem profiles de sessões persistentes ou têm capacidade real de hospedagem própria podem validar primeiro o Browserless. Se o portal já oferece uma API autorizada de relatórios ou entrega agendada, avalie primeiro essa via menos dependente do estado da página. O critério de aprovação é conseguir explicar a origem de cada arquivo após desconexões, expiração e reexecuções.

Nota sobre o conteúdo:Este artigo foi elaborado com base em informações públicas e serve como referência para a escolha de ferramentas. Os recursos, os preços e as políticas relacionadas podem mudar a qualquer momento; consulte as informações oficiais mais recentes.

Fonte original:docs.browserbase.com