Browserbase et Browserless : transmettre connexion, session et fichiers après l’interruption d’un téléchargement de rapport

Browserbase convient aux tâches séquentielles privilégiant une transmission de fichiers gérée et le diagnostic. Browserless propose différents chemins pour la reconnexion courte, les sessions persistantes et les instantanés de connexion. Il faut vérifier reprise après déconnexion, expiration de l’authentification et exports en double, sans confondre connexion sauvegardée ou replay avec exécution reprenable.

Source: docs.browserbase.com
16 novembre 2026
8 min

Une collègue des opérations exporte un rapport quotidien depuis un portail fournisseur auquel elle est autorisée à accéder. Le script perd la connexion juste après avoir cliqué sur « Générer le rapport ». La personne qui reprend doit savoir : peut-on retrouver la même page ? Faudra-t-il se reconnecter demain ? Le fichier a-t-il réellement été téléchargé ? Browserbase et Browserless fournissent tous deux une infrastructure de navigateur distant, mais ces questions relèvent respectivement de la session en cours, des données de connexion persistantes et du suivi de la tâche métier.

Pour réunir Context, téléchargements cloud et diagnostic visuel dans un processus géré, évaluez d’abord Browserbase. Si vous possédez déjà un workflow Puppeteer ou Playwright et devez choisir explicitement entre reconnexion courte, état entre exécutions et instantané de connexion indépendant, Browserless propose des chemins plus détaillés, mais exige de distinguer les interfaces. Cet article repose sur des sources officielles vérifiées le 10 novembre 2026. Il porte uniquement sur les téléchargements ordinaires de rapports depuis des portails propres ou autorisés, sans contournement des restrictions d’accès ni résolution automatique de CAPTCHA. Aucun vrai test de connexion ou de téléchargement n’a été exécuté.

Que conserver pour relancer demain

Les Contexts de Browserbase conservent les données de connexion et d’application du répertoire utilisateur Chromium, dont cookies, localStorage et IndexedDB. Une nouvelle session doit recevoir le Context ID. Pour réenregistrer les modifications, définissez persist: true à la création. Les données sont sauvegardées à la fermeture de la session ; attendez quelques secondes de synchronisation avant réutilisation. La recommandation officielle est un Context distinct par connexion à un site, afin d’éviter les déconnexions causées par l’usage simultané du même Context.

La fiche de transmission doit donc distinguer Context ID et session ID : le premier charge les données dans un nouveau navigateur, le second identifie une exécution. L’objet BrowserContext d’un framework, les données persistantes et le navigateur en cours ne sont pas la même chose. L’existence d’un Context ne garantit pas non plus une connexion valide. Le portail peut faire expirer un cookie, révoquer un jeton ou demander une nouvelle authentification. Une MFA réussie une fois n’implique pas une dispense permanente.

La Session API de la documentation v2 actuelle de Browserless permet de conserver cookies, localStorage et cache entre redémarrages du navigateur. ttl contrôle la durée de vie des données. Avec la valeur par défaut processKeepAlive: 0, une reconnexion après déconnexion lance un nouveau processus sur une page vierge ; il faut naviguer à nouveau. Les pages ouvertes et l’état en cours ne sont conservés que s’il existe un délai de grâce et que le processus est toujours vivant. Ce maintien du processus est limité à Puppeteer. Une session persistante n’autorise qu’un client connecté à la fois et ne constitue pas un poste partagé entre plusieurs personnes.

Les Authenticated Profiles offrent une autre voie : ils sauvegardent un instantané de cookies, localStorage et IndexedDB, puis chargent une copie indépendante pour chaque session, sans conserver sessionStorage. Les modifications en cours d’exécution ne réécrivent pas automatiquement le profile original. Cela convient à plusieurs tâches autorisées qui réutilisent un même point de départ connecté, pas au partage de la même page de rapport. Il faut décider à l’avance qui met à jour l’instantané après renouvellement de la connexion.

Quel navigateur préserver pour revenir quelques minutes plus tard

Le keepAlive de Browserbase laisse la même session attendre une connexion après déconnexion ; il n’est disponible que dans les offres payantes. À la fin du travail, libérez-la explicitement, sinon elle tourne jusqu’au délai d’expiration et consomme du navigateur inutilisé. Cela résout une transmission courte, sans remplacer la persistance entre sessions assurée par Context.

Les Standard Sessions de Browserless exigent de récupérer un endpoint de reconnexion avant de se déconnecter. La documentation spécifique actuelle limite ce chemin à Puppeteer. La fenêtre d’attente reste soumise à la durée maximale de session du forfait, calculée depuis le lancement initial. Des reconnexions répétées ne prolongent pas indéfiniment la session ; chacune est facturée comme une nouvelle connexion, et l’attente occupe toujours un emplacement de concurrence. Les équipes Playwright doivent concevoir leur workflow à partir de la documentation de persistance d’état, sans recopier les règles de déconnexion de Puppeteer.

Lors de l’organisation des relais, distinguez aussi la personne qui attend le navigateur du navigateur qui attend la personne. Si le rapport est en cours de génération, une session courte peut être maintenue. Pour une reprise le lendemain, privilégiez la sauvegarde des données nécessaires et des points de contrôle métier. Sinon, des connexions inactives consomment des ressources et la personne qui reprend peut recevoir une adresse déjà expirée. Le planificateur de tâches doit consigner la validité et la responsabilité du nettoyage ; une capture de replay ne peut pas s’en charger.

Cela détermine également le rôle des scripts de deux équipes successives : une brève coupure réseau peut justifier de tenter une reconnexion à une session encore valide. Si le navigateur est terminé, il faut lire le point de contrôle métier et rouvrir la liste des rapports plutôt que cliquer aveuglément sur « Générer ». Aucun des deux fournisseurs ne garantit, par la seule reconnexion du navigateur, une exécution exactement une fois dans le système métier.

Le replay explique l’échec, mais le fichier est le livrable

La documentation des téléchargements de Browserbase indique que les fichiers sont stockés dans le cloud puis récupérés par API, avec un horodatage ajouté au nom pour réduire les collisions. Enregistrer un clic ne suffit pas : il faut vérifier la date du rapport, la taille et le contenu du fichier récupéré. La documentation des transferts de fichiers de Browserless présente un chemin CDP recevant les octets après activation des événements de téléchargement, ainsi que Download.saveAs() avec une connexion Playwright native. Les écouteurs doivent être enregistrés avant le déclenchement du téléchargement. Dès le choix de la connexion, déterminez comment le fichier arrivera dans le stockage de l’équipe.

Le replay de session actuel de Browserbase permet une lecture HLS par onglet et propose le téléchargement de l’enregistrement. Le Session Replay de Browserless s’active avec replay=true, enregistre notamment les modifications du DOM et diffère de l’enregistrement d’écran qui renvoie du WebM. Les deux aident à repérer une mauvaise date sélectionnée ou une étape bloquée, mais regarder l’enregistrement ne restaure pas un processus disparu et ne relance pas automatiquement un téléchargement manquant.

À la transmission, reliez identifiant de tâche, périmètre du rapport, état d’export, résultat de vérification du fichier et enregistrement de session. Le replay peut contenir des informations métier et les données de connexion donnent accès au compte : limitez leur visibilité et leur durée de conservation. Ne collez pas une adresse de connexion contenant un jeton dans un ticket ordinaire.

Vérifier d’abord la transmission, choisir ensuite le déploiement

Un test d’acceptation hypothétique peut télécharger les rapports quotidiens de 3 jours consécutifs avec le même compte autorisé. Le premier jour, interrompez après « Générer » ; le script de reprise consulte d’abord l’historique des exports du portail. Le deuxième jour, terminez le navigateur puis rechargez les données persistantes, confirmez le bon compte et naviguez à nouveau. Le troisième jour, rendez volontairement la connexion invalide pour vérifier que la tâche s’arrête et confie l’authentification au propriétaire du compte, plutôt que réessayer indéfiniment. Chaque jour, vérifiez date du fichier, contenu non vide et identifiant de tâche. En cas de nouvelle exécution, dédupliquez à partir des exports existants et de la vérification des fichiers. C’est un protocole d’acceptation, pas un test de fiabilité déjà terminé.

Il faut aussi séparer couche d’automatisation et infrastructure. Stagehand fournit des opérations en langage naturel, de l’extraction et des interfaces de contrôle programmatique. Ce n’est pas tout le service Browserbase, et son adoption ne règle pas automatiquement les responsabilités de session, de fichier et de réexécution. Un script de téléchargement doté de sélecteurs stables n’a pas besoin d’être réécrit en agent IA pour acheter un navigateur cloud.

Les instructions d’auto-hébergement de Browserless distinguent l’image Docker de base des fonctions Enterprise. Le replay cloud, BrowserQL et les autres capacités ne doivent pas être considérés comme tous inclus par défaut dans l’image gratuite. La LICENSE du dépôt prévoit SSPL ou une licence commerciale et signale explicitement les exigences de licence commerciale pour les applications commerciales à code fermé et l’intégration continue. L’évaluation de l’auto-hébergement doit inclure mises à jour du navigateur, capacité, stockage et maintenance de sécurité, pas seulement comparer facture cloud et prix d’un serveur.

En définitive, pour des téléchargements séquentiels sur un seul compte avec priorité à la transmission gérée des fichiers et au diagnostic, vérifiez d’abord Browserbase. Pour réutiliser les clients existants, distinguer profiles et sessions persistantes, ou avec une réelle capacité d’auto-hébergement, vérifiez d’abord Browserless. Si le portail propose déjà une API de rapports autorisée ou une livraison programmée, évaluez d’abord cette voie moins dépendante de l’état des pages. Le choix est validé si, après déconnexion, expiration et réexécution, l’origine de chaque fichier reste explicable.

À propos de cet article :Cet article s’appuie sur des informations publiques et sert de référence pour vous aider à choisir vos outils. Les fonctionnalités, les tarifs et les politiques associées peuvent évoluer à tout moment ; veuillez consulter les informations officielles les plus récentes.

Source originale :docs.browserbase.com