Cómo recuperar un trabajo del navegador después de una desconexión
TL;DR
Reconéctese al ID del navegador original cuando un trabajador pierda su conexión y el proveedor aún informe que la sesión original está ready.
Emita credenciales de corta duración para esa sesión, confirme su identidad y mantenga la clave API del negocio fuera de la conexión del navegador.
Seleccione la pestaña original mediante una URL aprobada y un punto de control específico del trabajo. Trate una pestaña faltante o ambigua como una decisión de reconciliación.
Lea un recibo comercial duradero antes de volver a intentar una acción cuya respuesta se perdió.
Una sesión del navegador ended requiere una nueva sesión si el trabajo puede reanudarse de manera segura. Reconstruir un navegador no puede establecer lo que sucedió en la aplicación.
Verifique la aceptación de tareas y el cierre de sesión de forma independiente. Un nuevo WebSocket y un navegador detenido prueban cosas diferentes.
¿Cuándo puede reconectarse a un navegador remoto?
Puede reconectarse a un navegador remoto cuando el tiempo de ejecución original aún esté disponible y pueda obtener credenciales de conexión actuales para esa misma sesión. Una desconexión de red le dice lo que el trabajador observó. El navegador puede seguir teniendo sus páginas abiertas, y la aplicación de destino puede haber aceptado ya la última acción. Nstdata documenta un flujo de adjunto para sesiones existentes de Cloud Browser como parte de su servicio de automatización de navegadores.
Suponga que un revisor de lanzamientos ha llegado a un informe de preparación y el trabajador se desconecta justo después de hacer clic en un control de aprobación. La plataforma del navegador puede informar si la sesión existe. El informe puede mostrar qué revisión está en pantalla. El registro autorizado de la aplicación determina si la aprobación se comprometió. Esas son tres piezas distintas de evidencia. El trabajador debe restaurar la observación antes de decidir actuar.
La guía del ciclo de vida de la sesión del navegador cubre la creación y terminación de sesiones. La recuperación comienza más tarde, con un trabajo existente y una ID de sesión persistente. La cubre el caso diferente donde una respuesta de creación puede haberse perdido y el trabajador nunca supo qué sesión fue asignada.
¿Qué estado debe preservar un trabajador antes de cualquier desconexión?
Almacene las identidades del trabajo y la sesión, el límite de página esperado y el punto de control de la aplicación antes de entrar en un paso que podría cambiar el estado del negocio. Un registro pequeño podría contener un ID de trabajo, una etiqueta de espacio de trabajo, un ID de sesión del navegador, un origen aprobado, una ruta esperada, un valor de punto de control seguro y una referencia de operación de la aplicación. Mantenga su política de acceso separada de las credenciales del navegador.
Lo que restauras
Evidencia a preservar
Decisión tras volver a conectarse
Propiedad del navegador
ID de sesión, propietario del trabajo, espacio de trabajo previsto
Inspeccionar la sesión original
Identidad de la página
Origen aprobado, ruta esperada, marcador específico de la tarea
Reanudar la observación solo si la página es única
Progreso del negocio
Último punto de control y referencia de operación comprometida
Leer el resultado duradero antes de cualquier acción nueva
Responsabilidad de limpieza
Un propietario de parada y una fecha límite de lanzamiento
Mantener la reconciliación activa hasta que se confirme el cierre
Evite persistir la dirección WebSocket firmada o un token de acceso en el registro de trabajo. Almacene el identificador utilizado para solicitar credenciales frescas a través de la interfaz soportada. Ese enfoque le da a un trabajador de reemplazo un punto de partida duradero sin exponer una conexión reutilizable en una cola, ticket o traza. Consulte la guía de ciclo de vida de secretos OWASP.
¿Cómo recupera la sesión original y localiza su pestaña?
Inspeccione la sesión existente, establezca una conexión CDP limitada y verifique la página exacta y el punto de control antes de tomar otra acción. El flujo de trabajo supone acceso al espacio de trabajo original, la ID de sesión registrada y una vista segura de la aplicación de destino. El ejemplo local utiliza Node.js 22, playwright-core@1.65.1, y el accesorio compañero. Instale Chromium con npx playwright-core install chromium para la rama local.
Paso 1. Lea el registro de la sesión
Abra Cloud Browser → Session History en el espacio de trabajo previsto y encuentre la sesión original. En código, inspeccione GET /sessions/{sessionId} bajo la API base documentada de Cloud Browser. Trate ready como permiso para proceder a la emisión de credenciales, sujeto a autorización. Si se está realizando una parada, observe hasta que la plataforma se estabilice. Si la sesión está ended, use un punto de control de la aplicación para decidir si una nueva sesión puede continuar de manera segura. Documentación de automatización del navegador Cloud Browser.
[Captura de pantalla: Muestre una sesión de prueba en el Historial de sesiones, su estado y la referencia de trabajo coincidente. Oculte los identificadores de cuenta y sesión.]
Paso 2. Obtenga credenciales de conexión actuales
Para una sesión lista, solicite POST /sessions/{sessionId}/automation-credentials con la credencial de API de negocios y el contexto de espacio de trabajo correcto. Verifique el ID de sesión y la expiración devueltos. Proporcione la dirección CDP y el encabezado devueltos al cliente utilizando la construcción de encabezado documentada. Nunca registre una dirección firmada completa o el encabezado de autenticación. Utilice la documentación de Playwright BrowserType para las opciones y límites de protocolo de connectOverCDP().
Paso 3. Encuentre la pestaña original sin crear una nueva
Ejecute node recover.mjs con un LOCAL_CDP_URL de bucle invertido y un APP_ORIGIN que sirva la fixture compañera. Inicie node fixture.mjs y abra su ruta /recover una vez en el navegador de prueba. El cliente adjunto busca contextos existentes para una coincidencia exacta única, luego lee el marcador de fixture esperado. El verificador compañero provee un perfil de Chromium temporal, verifica que la página original sobreviva a la desconexión del cliente y verifica que dos pestañas coincidentes causen un rechazo. La rama gestionada requiere una clave Nstdata autorizada y una sesión lista existente con un punto de control de aplicación aprobado equivalente. Use un punto de control de prueba accesible dentro del entorno autorizado del navegador gestionado.
const root ='https://api.nstdata.io/api/v1/cloud-browser';exportasyncfunctionapi(method, path, body){const key = process.env.NSTDATA_API_KEY;if(!key)thrownewError('Set NSTDATA_API_KEY');const headers ={'x-api-key': key };if(process.env.NSTDATA_TEAM_ID) headers['x-team-id']= process.env.NSTDATA_TEAM_ID;if(body) headers['content-type']='application/json';let response;try{ response =awaitfetch(root + path,{ method, headers,redirect:'error',body: body ?JSON.stringify(body):undefined,signal:AbortSignal.timeout(20_000),});}catch{throwObject.assign(newError('API transport failed; reconcile the original operation'),{retryable:true});}const retryable = response.status===429|| response.status>=500;let result;try{ result =await response.json();}catch{throwObject.assign(newError('Invalid API JSON'),{ retryable });}if(!response.ok|| result.err===true|| result.success===false){throwObject.assign(newError(`Cloud Browser API HTTP ${response.status}`),{ retryable });}if(!result.data)thrownewError('Missing API data');return result.data;}exportasyncfunctionconnection(id){if(!id)thrownewError('Set NSTDATA_SESSION_ID');const path =`/sessions/${encodeURIComponent(id)}`;const session =awaitapi('GET', path);if(session.state!=='ready')thrownewError(`Session is ${session.state}, not ready`);const c =awaitapi('POST', path +'/automation-credentials');if(c.sessionId!== id ||!c.headerName||!c.accessToken||!(Date.parse(c.expiresAt)>Date.now())||newURL(c.cdpUrl).protocol!=='wss:'){thrownewError('Invalid or expired CDP credentials');}return{endpoint: c.cdpUrl,headers:{[c.headerName]: c.headerName.toLowerCase()==='authorization'?`Bearer ${c.accessToken}`: c.accessToken},};}exportasyncfunctionendpoint(){// An isolated local CDP endpoint can test the client without managed credentials.if(process.env.LOCAL_CDP_URL){const url =newURL(process.env.LOCAL_CDP_URL);if(!['127.0.0.1','localhost','[::1]'].includes(url.hostname)){thrownewError('LOCAL_CDP_URL must use loopback');}return{endpoint: url.href,headers:{}};}returnconnection(process.env.NSTDATA_SESSION_ID);}
El resultado de la fixture esperado contiene solo la etiqueta de trabajo seguro, el punto de control observado y la próxima decisión. El resultado es intencionadamente reconcile, porque ver una página marcada como revisada no puede probar que una escritura de aplicación posterior se completó. Cuando un flujo de trabajo real navega normalmente o abre una nueva pestaña, define las rutas y marcadores exactos aprobados para cada transición. La guía de Playwright sobre páginas y pestañas explica la relación entre páginas y contextos del navegador.
Paso 4. Verifica la aplicación antes de volver a reproducir una escritura
Busca el recibo comercial o el estado utilizando una ruta de aplicación de solo lectura. Si el resultado ya existe para la operación original, marca la tarea como aceptada a partir de esa evidencia y programa la limpieza. Si el resultado está ausente, confirma que la solicitud original se ha asentado antes de decidir repetirla. Donde la aplicación de destino admite una clave de idempotencia, conserva la referencia de la operación original y sigue las reglas de esa aplicación. Un resultado ambiguo va al operador o a la cola de reconciliación con un plazo determinado.
¿Qué debería suceder si falla un paso de recuperación?
Un paso de recuperación fallido debería preservar el estado existente e informar qué capa impidió la verificación. Una búsqueda de sesión que falla no puede establecer si el navegador aún existe. Un WebSocket exitoso sin una página coincidente es un éxito de adjunto y un fallo de selección de página. Estos estados requieren diferentes acciones siguientes.
Síntoma
Causa probable a verificar
Próxima acción
La sesión original es terminal
Tiempo de espera, parada explícita o resultado del ciclo de vida del proveedor
Lee el punto de control duradero antes de asignar un reemplazo
Conexión rechazada
Espacio de trabajo incorrecto, credenciales expiradas o mala construcción de encabezados
Inspecciona el estado original y emite credenciales actuales una vez que la configuración esté corregida
Dos páginas coinciden con la URL
Pestaña duplicada o propiedad paralela
Detén la automatización y exige un marcador de tarea más sólido o una selección de pestaña explícita
La página muestra una pantalla completada sin un recibo
Estado incompleto o UI obsoleta
Verifica el registro de operaciones del lado de la aplicación
La limpieza permanece pendiente
Resultado de detención no confirmado
Mantén la sesión rastreada e inspecciona su estado terminal
Si un nuevo trabajador puede comenzar mientras uno viejo aún está conectado, usa una verificación de arrendamiento de aplicación o propiedad antes de emitir cualquier escritura. Libera la capacidad del navegador solo después de que se confirme la limpieza de acuerdo con el ciclo de vida del proveedor. La guía de autenticación de CDP ayuda a aislar un fallo de configuración antes de que el trabajador toque la página.
¿Cómo encaja Nstdata Cloud Browser en un manual de recuperación?
Nstdata Cloud Browser proporciona navegadores en la nube gestionados para automatización de navegadores y agentes de IA, con estado de sesión y adjunto de CDP documentado. Un equipo puede usar el mismo servicio para la ejecución rutinaria de tareas y recuperación supervisada mientras mantiene sus propios puntos de control de aplicación. Usa el adjunto de sesión existente cuando el espacio de trabajo aún posee un tiempo de ejecución listo. Live View puede ayudar a un operador autorizado a validar una página que la automatización no puede identificar de manera única. La información de la sesión del servicio no puede establecer si una aprobación de preparación u otra acción de aplicación se comprometió.
Búsqueda de sesión. Usa el ID anterior para inspeccionar el estado del ciclo de vida y evitar asignar un reemplazo en un error de transporte.
Adjunto de corta duración. Solicita credenciales actuales para la sesión, mantenlas dentro del trabajador y persiste solo la referencia de operación segura.
Evidencia del operador. Usa observaciones disponibles para entender qué página estaba activa o atascada. Mantén capturas de pantalla sensibles, URLs y registros fuera de tickets rutinarios.
Limpieza explícita. Asigna al controlador que detendrá el navegador gestionado. Cerrar el adjunto y finalizar la sesión gestionada son operaciones separadas.
¿Qué debería demostrar un ejercicio de recuperación?
Un ejercicio de recuperación debería demostrar que un trabajador sustituto puede encontrar la página correcta, reconocer un estado comercial incierto y detener la sesión original bajo una propiedad conocida. Comienza con un informe de preparación autorizado, desconecta al trabajador antes de un punto de control de solo lectura y verifica que el reemplazo lea el mismo marcador de tarea. Repite con una pestaña competidora y un punto de control que no puede resolver el resultado comercial. La primera ejecución debería continuar la observación, mientras que las otras ejecuciones deberían detenerse o escalar con una razón accionable.
Registre el tiempo transcurrido desde la desconexión hasta la disposición verificada y cuente los casos que requirieron un humano. Realice un seguimiento del éxito del trabajo y de la limpieza del navegador por separado. Cuando una falla necesite revisión forense, considere la grabación y reproducción de sesiones para casos de prueba sintéticos con retención aprobada.
Q: ¿Significa que una WebSocket caída que el navegador original se detuvo?
El estado del navegador es determinado por el registro de sesión del proveedor. Consultar el ID original antes de reconectar o reemplazar el navegador.
Q: ¿Se puede reabrir una sesión de Cloud Browser finalizada?
Trate la sesión finalizada como terminal. Utilice el estado de aplicación persistente para elegir un próximo paso seguro en una nueva sesión.
Q: ¿Debería un trabajador de recuperación crear una página nueva?
Seleccione la página existente cuando necesite su estado. Abra una nueva página solo para un flujo de trabajo que permita explícitamente reconstruir el contexto.
Q: ¿Se puede reutilizar una dirección CDP antigua después de una desconexión?
Solicite las credenciales actuales para la sesión lista original y verifique la fecha de caducidad documentada. Almacene solo una referencia segura de la sesión para la recuperación posterior.
Q: ¿Qué debería ver un operador en una escalación?
Proporcione el ID del trabajo, fase segura, estado del navegador, evidencia de resultado y propietario de limpieza. Comparta artefactos protegidos a través del canal de incidente aprobado.
Marcus Chen
Nov. 20th 2026
Inicia navegadores en la nube bajo demanda
Gestiona huellas digitales y CAPTCHA
Automatiza flujos de trabajo e impulsa agentes de IA
Desde la extracción de datos web y las pruebas hasta la automatización con IA, ejecútalo todo en la nube.