Volver al Centro de conocimiento
Plataforma

Resiliencia de BrowserContext de larga duración

Diseña contextos que se recuperen de fallos, interrupciones de red y mantenimiento sin perder la propiedad del almacenamiento ni la coherencia.

BotBrowser Team

Documentación

Quieres la documentación estructurada de Plataforma?

Este artículo forma parte de la biblioteca editorial. Para pasos de configuración, material de referencia y actualizaciones continuas, entra en la sección de docs.

Un script breve puede crear un contexto y terminar antes de que aparezca una interrupción de red o un problema gradual. Un BrowserContext que permanece activo durante horas debe gestionar fallos del navegador, cortes temporales, leases vencidos, mantenimiento y reinicios. BotBrowser Team ofrece configuración repetible de perfiles y BrowserContext para automatización autorizada, pero no garantiza funcionamiento ininterrumpido ni restaura estado de página no guardado. La meta es hacer previsibles la continuación, recuperación y cierre.

Resumen

Usa un lease con propietario, checkpoints confirmados por la aplicación, reintentos limitados y limpieza verificable. BotBrowser no garantiza ejecución ininterrumpida ni durabilidad de transacciones.

Ciclo de recuperación coherente de un contexto de navegador

Resumen: Usa un lease con propietario, checkpoints confirmados por la aplicación, reintentos limitados y limpieza determinista. BotBrowser permite configurar perfiles y BrowserContext autorizados de forma repetible, pero no garantiza continuidad ni restaura estado no guardado.

Contenido

El contexto es un lease con propietario

Cada contexto necesita un propietario y un registro de ciclo de vida. El registro puede incluir la referencia del trabajo, el perfil aprobado, las políticas de almacenamiento y ruta, la versión del navegador y las marcas de creación, checkpoint y cierre. No debe guardar credenciales ni contenido de páginas.

Usa estados como planned, starting, active, degraded, draining y closed. Las transiciones deben ser idempotentes porque una notificación puede repetirse. El lease tiene vencimiento y regla de renovación. Cuando la renovación se detiene, el planificador pausa el trabajo nuevo y comienza la reconciliación.

Perfil, almacenamiento, ruta y configuración regional permanecen unidos al lease. La recuperación puede recrear la misma asignación aprobada, pero no debe sustituirla silenciosamente. Si hace falta otra identidad, cierra el lease anterior y crea una nueva sesión.

Separar intención persistente y estado volátil

El proceso, las páginas abiertas y las conexiones son volátiles. La intención persistente describe el objetivo, el último checkpoint confirmado, el presupuesto de reintentos y la limpieza. Un checkpoint debe representar una confirmación de la aplicación, no solo una navegación correcta.

Escribe el checkpoint junto con la versión del lease. Un conflicto de versión exige reconciliación, no una segunda ejecución. Cookies, almacenamiento local, descargas y borradores tienen reglas distintas. Persiste solo lo que la política autoriza y que puede restaurarse de forma comprensible.

Hacer reproducibles el inicio y la restauración

Antes de abrir la primera página, valida la versión, la propiedad del almacenamiento y la ruta. La restauración sigue una secuencia fija: adjuntar la asignación, crear el contexto, aplicar ruta y configuración regional, ejecutar una comprobación de salud y reanudar el trabajo. Registra una generación para rechazar mensajes tardíos del worker anterior.

El inicio debe tener un límite. Si el contexto no se vuelve saludable, pasa a revisión o a un reintento controlado. Esperar sin límite oculta la saturación y conserva un espacio del planificador.

Recuperarse de un fallo del navegador

Marca el lease como degradado y detén el trabajo nuevo. Conserva evidencia no sensible: versión, generación, último checkpoint y estado del host. Si hay otros contextos en el mismo grupo, el propietario del grupo decide si el impacto es local o general.

Reutiliza almacenamiento solo cuando su integridad sea conocida. De lo contrario, aíslalo y usa el estado permitido. Las acciones de recuperación deben ser idempotentes. Si una operación ya pudo completarse, pide confirmación a la aplicación antes de repetirla. Ante la duda, detente en el checkpoint.

Dar un presupuesto a los reintentos de red

Una solicitud, una conexión larga y el canal de control son fallos diferentes. Registra la categoría, limita los intentos y añade espera. Las lecturas pueden repetirse, pero una escritura o un envío requiere confirmación de la aplicación. Los pasos para reanudar una sesión tras una interrupción de este tipo se describen en Recuperar una sesión del navegador tras una interrupción de red.

Los reintentos deben usar la ruta aprobada. Si cambiar de ruta cambia la identidad regional, cierra el lease y crea una sesión nueva. Cuando se agota el presupuesto, marca un fallo recuperable y libera capacidad solo después de limpiar el contexto.

Reciclar en una frontera explícita

El reciclaje puede producirse por mantenimiento, una actualización o un estado imposible de reparar. Detén la admisión, termina o cancela la acción, escribe el checkpoint final, cierra páginas y contexto, y confirma la limpieza antes de liberar el lease. Nunca reemplaces el navegador bajo un contexto activo.

Una sesión autorizada no debe reciclarse solo para cambiar de identidad. Si la política exige una nueva asignación, registra la frontera y no reutilices el almacenamiento anterior.

Validar la coherencia

Observa las relaciones: un lease por propietario, un almacenamiento por contexto, checkpoints ordenados y un cierre para cada apertura. Los paneles pueden mostrar edad de cola, restauraciones, fallos, reintentos y tiempos de cierre sin guardar secretos ni contenido privado.

Para una verificación reproducible, ejecuta un trabajo aprobado y provoca una sola interrupción controlada. Compara asignación, configuración regional, ruta, propiedad del almacenamiento, checkpoints y resultado final. Comprueba además que el contexto antiguo está cerrado y que el nuevo tiene un solo propietario.

Consulta el Proof Center de BotBrowser para conocer el alcance público de validación de coherencia. La guía de memoria de BrowserContext y escalado de contextos cubren capacidad y ciclo de vida.

BotBrowser permite configurar de forma repetible los perfiles y el ciclo de vida de BrowserContext entre sesiones de automatización. Esto no garantiza un funcionamiento ininterrumpido ni restaura el estado de página que no se guardó antes de una interrupción.

Lista operativa

  • El lease tiene propietario, vencimiento y transiciones repetibles.
  • Perfil, almacenamiento, ruta y versión se asignan antes del trabajo.
  • Los checkpoints no contienen secretos.
  • Los fallos y reintentos tienen límites claros.
  • El reciclaje confirma la limpieza antes de devolver capacidad.
  • Las pruebas comparan registros estructurados y verifican el cierre.

Si la propiedad o la limpieza es incierta, pausa la admisión y reconcilia primero. El navegador puede reiniciarse y el worker puede cambiar, pero el servicio debe explicar qué asignación estaba activa, qué trabajo se confirmó y por qué se creó un contexto nuevo.

Artefacto para el lector: recibo de recuperación

Registra un recibo pequeño y redactado por interrupción, no una copia de la sesión:

run_id: synthetic-checkout-2026-09-29-07
lease_version_before: 12
lease_version_after: 13
generation: 5
browser_release: approved-release-id
profile_ref: approved-profile-ref
storage_ref: controlled-storage-ref
checkpoint: order-confirmed
interruption: worker-restart
action: new-context-from-approved-storage
result: resumed-and-closed
cleanup: old-context-closed; new-context-single-owner
retention: 14d; sin credenciales, URL ni contenido

Fuentes públicas: ciclo de vida de página en MDN, Fetch en MDN y BrowserContext de Playwright. Explican APIs, no garantizan que una transacción sea durable; combina el recibo con la confirmación de la aplicación.

Evidencia de recuperación

Conserva la evidencia mínima necesaria para explicar una recuperación sin retener contenido privado.

Límite de conservación

Define una ventana de retención y elimina los recibos cuando ya no sean necesarios.

Conclusión

Registra primero propietario, checkpoint y límites de almacenamiento; después recupera con un presupuesto finito y confirma la limpieza. Si no puedes explicar la decisión en un recibo breve, no devuelvas el contexto a la cola.

Fuentes públicas adicionales: W3C Service Workers, MDN Fetch API y Playwright BrowserContext.

Fuentes

#Browser Context#Resilience#Recovery#coherencia#automatización#Lifecycle

Este artículo forma parte de la guía: Superficies de la plataforma web: mapa de revisión

Ejecuta la misma comprobación en BotBrowser

Carga un perfil, mantén dentro del navegador las señales que acabas de leer y confirma el resultado en tu propia máquina antes del despliegue.