Browserbase y Browserless: cómo traspasar inicio de sesión, sesión y archivos tras una descarga de informes interrumpida

Browserbase encaja con tareas secuenciales centradas en la entrega gestionada de archivos y el diagnóstico. Browserless ofrece vías distintas para reconexión breve, sesiones persistentes e instantáneas de acceso. Hay que verificar recuperación tras cortes, caducidad de autenticación y exportaciones duplicadas, sin confundir acceso guardado o reproducción de sesiones con ejecución reanudable.

Fuente: docs.browserbase.com
16 de noviembre de 2026
8 min

Una compañera de operaciones exporta el informe diario de un portal de proveedores al que tiene acceso autorizado. El script se desconecta justo después de pulsar «Generar informe». Quien toma el relevo necesita saber: ¿se puede volver a la misma página? ¿Mañana habrá que iniciar sesión de nuevo? ¿Se descargó realmente el archivo? Browserbase y Browserless ofrecen infraestructura de navegadores remotos, pero esas preguntas corresponden, respectivamente, a la sesión en ejecución, los datos persistentes de acceso y el registro de la tarea de negocio.

Si se busca reunir Context, descargas en la nube y diagnóstico visual en un flujo gestionado, conviene evaluar primero Browserbase. Si ya existe un flujo Puppeteer o Playwright y se necesita elegir entre reconexión breve, estado entre ejecuciones e instantáneas de acceso independientes, Browserless ofrece vías más detalladas, aunque exige distinguir interfaces. Este artículo se basa en documentación oficial. Solo trata descargas ordinarias de informes en portales propios o autorizados, sin eludir restricciones de acceso ni resolver CAPTCHA automáticamente. No se realizaron pruebas reales de inicio de sesión o descarga.

Qué guardar para ejecutar de nuevo mañana

Los Contexts de Browserbase guardan datos de acceso y aplicación del directorio de usuario de Chromium, incluidos cookies, localStorage e IndexedDB. Una sesión nueva debe recibir el Context ID. Para guardar cambios de vuelta, se configura persist: true al crearla. Los datos se guardan al cerrar la sesión; antes de reutilizarlos conviene esperar unos segundos de sincronización. La recomendación oficial es un Context independiente para cada acceso a un sitio, para evitar cierres de sesión por uso simultáneo del mismo Context.

Por tanto, la ficha de traspaso debe registrar Context ID y session ID por separado: el primero permite cargar datos en un navegador nuevo y el segundo identifica una ejecución. El objeto BrowserContext del framework, los datos persistentes y el navegador en funcionamiento no son lo mismo. Que exista un Context tampoco garantiza un acceso válido: el portal puede caducar cookies, revocar tokens o exigir nueva autenticación. Superar MFA una vez no implica una exención permanente.

La Session API de la documentación v2 actual de Browserless permite conservar cookies, localStorage y caché entre reinicios del navegador. ttl controla la vida de los datos. Con el valor predeterminado processKeepAlive: 0, volver a conectar tras desconectarse inicia un proceso nuevo con una página en blanco, por lo que hay que navegar de nuevo. Solo se conservan las páginas abiertas y el estado actual si existe un periodo de gracia y el proceso sigue vivo. Esta capacidad de mantener vivo el proceso se limita a Puppeteer. Una sesión persistente solo admite un cliente conectado a la vez; no es un escritorio compartido para varias personas.

Otra opción son los Authenticated Profiles: guardan una instantánea de cookies, localStorage e IndexedDB y cargan una copia independiente en cada sesión, sin conservar sessionStorage. Los cambios durante la ejecución no reescriben automáticamente el profile original. Sirven para que varias tareas autorizadas reutilicen el punto de partida autenticado, no para compartir la misma página de informes. Hay que decidir de antemano quién actualiza la instantánea después de renovar el acceso.

Qué navegador conservar para volver dentro de unos minutos

El keepAlive de Browserbase deja que la misma sesión espere una conexión después de desconectarse y solo está disponible en planes de pago. Al terminar, debe liberarse explícitamente; de lo contrario, sigue funcionando hasta agotar el tiempo y genera uso de navegador inactivo. Resuelve relevos breves, pero no sustituye la persistencia entre sesiones de Context.

Las Standard Sessions de Browserless exigen obtener primero un endpoint de reconexión y después desconectarse. La documentación específica actual limita esa vía a Puppeteer. La ventana de espera también está sujeta a la duración máxima de sesión del plan, calculada desde el lanzamiento original. Reconectar repetidamente no la prolonga indefinidamente; cada reconexión se factura como una conexión nueva y la espera sigue ocupando una plaza de concurrencia. Los equipos que usan Playwright deben diseñar el flujo según la documentación de estado persistente, sin copiar la semántica de desconexión de Puppeteer.

Al organizar turnos, también hay que distinguir entre la persona que espera al navegador y el navegador que espera a la persona. Si se espera a que se genere el informe, puede conservarse una sesión breve. Si el trabajo seguirá al día siguiente, es preferible guardar los datos necesarios y puntos de control de negocio. De lo contrario, las conexiones inactivas ocupan recursos y quien toma el relevo puede recibir una dirección ya caducada. El planificador de tareas debe registrar la vigencia y quién se ocupa de la limpieza; una captura de una reproducción no puede asumir esas funciones.

Esto también define el reparto entre scripts de dos turnos: ante un corte de red breve puede intentarse reconectar a una sesión aún válida. Si el navegador ya terminó, hay que leer el punto de control de negocio y volver a abrir la lista de informes, en lugar de pulsar «Generar» a ciegas. Ninguno de los dos proveedores puede garantizar una ejecución exactamente una vez en el sistema de negocio solo mediante la reconexión del navegador.

La reproducción explica el fallo; el archivo es el entregable

La documentación de descargas de Browserbase indica que los archivos se almacenan en la nube y se recuperan por API, con una marca temporal añadida al nombre para reducir conflictos. Registrar un clic no basta: hay que comprobar fecha del informe, tamaño y contenido del archivo recuperado. La documentación de transferencia de archivos de Browserless ofrece una vía CDP que recibe los bytes tras habilitar eventos de descarga y muestra también Download.saveAs con una conexión nativa de Playwright. Los listeners deben registrarse antes de activar la descarga. Al elegir la conexión, debe quedar claro cómo llegará el archivo al almacenamiento del equipo.

La reproducción de sesiones actual de Browserbase admite reproducción HLS por pestaña y permite descargar la grabación. El Session Replay de Browserless se activa con replay=true, registra eventos como cambios del DOM y es distinto de la grabación de pantalla que devuelve WebM. Ambos ayudan a identificar una fecha mal seleccionada o un paso bloqueado, pero ver la grabación no recupera un proceso desaparecido ni repone automáticamente una descarga pendiente.

En el traspaso deben vincularse el identificador de tarea, el alcance del informe, el estado de exportación, el resultado de validación del archivo y el registro de sesión. La reproducción puede contener información de negocio y los datos de acceso permiten entrar en la cuenta: limite quién los ve y cuánto tiempo se conservan. No pegue direcciones de conexión con tokens en tickets ordinarios.

Verificar primero el traspaso y decidir después el despliegue

Una aceptación hipotética puede descargar informes diarios de 3 días consecutivos con la misma cuenta autorizada. El primer día, interrumpa después de «Generar»; el script de relevo consulta primero el historial de exportaciones del portal. El segundo, cierre el navegador y cargue después los datos persistentes, confirme que sigue siendo la cuenta correcta y navegue de nuevo. El tercero, invalide deliberadamente el acceso para verificar que la tarea se pausa y deja la autenticación al propietario de la cuenta, en lugar de reintentar sin fin. Cada día se comprueban fecha del archivo, contenido no vacío e identificador de tarea. Al repetir, se eliminan duplicados mediante el historial de exportaciones existente y la validación del archivo. Es un diseño de aceptación, no una prueba de fiabilidad completada.

También hay que separar la capa de automatización de la infraestructura. Stagehand proporciona operaciones en lenguaje natural, extracción e interfaces de control programático. No es todo el servicio Browserbase, y elegirlo no resuelve automáticamente las responsabilidades sobre sesiones, archivos y reejecuciones. Un script de descarga con selectores estables no necesita convertirse en agente de IA para contratar un navegador en la nube.

Las instrucciones de autoalojamiento de Browserless distinguen la imagen Docker básica de las funciones Enterprise. La reproducción en la nube, BrowserQL y otras capacidades no deben darse por incluidas de serie en su totalidad en la imagen gratuita. La LICENSE del repositorio utiliza SSPL o licencia comercial y señala expresamente requisitos de licencia comercial para aplicaciones comerciales de código cerrado e integración continua. La evaluación del autoalojamiento también debe incluir actualizaciones del navegador, capacidad, almacenamiento y mantenimiento de seguridad, no solo comparar la factura de nube con el precio de un servidor.

En definitiva, los equipos con descargas secuenciales en una sola cuenta y prioridad en entrega gestionada de archivos y diagnóstico pueden verificar primero Browserbase. Quienes necesitan reutilizar clientes existentes, distinguir profiles de sesiones persistentes o realmente pueden autoalojar pueden verificar primero Browserless. Si el portal ya ofrece una API de informes autorizada o entrega programada, evalúe primero esa vía menos dependiente del estado de la página. La selección se valida cuando, tras desconexiones, caducidades y reejecuciones, sigue siendo posible explicar el origen de cada archivo.

Nota sobre el contenido:Este artículo se basa en información pública y sirve como referencia para comparar y elegir herramientas. Las funciones, los precios y las políticas relacionadas pueden cambiar en cualquier momento; consulta la información oficial más reciente.

Fuente original:docs.browserbase.com