Cómo reintentar tareas de Cloud Browser sin crear sesiones duplicadas
TL;DR
Persistir una intención de creación con un UUIDv4 requestId y su carga exacta antes de enviar la primera solicitud de creación.
En un fallo de creación recuperable, mantener el ID, cuerpo y espacio de trabajo originales mientras se aplica un retroceso acotado.
Si se conoce el ID de sesión, inspeccionar esa sesión en lugar de crear una segunda.
La idempotencia de creación protege el ciclo de vida del navegador. Un formulario de sitio web o compra necesita su propio resultado documentado y regla de reconciliación.
Mantener los intentos no resueltos visibles para un operador y honrar las pistas de reintento razonables cuando estén disponibles.
Confirmar que la sesión original ha terminado antes de considerar completa su limpieza.
¿Por qué los reintentos de automatización de navegador crean sesiones duplicadas?
Los reintentos de automatización de navegador crean sesiones duplicadas cuando un llamador confunde una respuesta perdida con una solicitud que nunca llegó. El servicio puede haber iniciado un navegador incluso si el trabajador se agotó antes de guardar la respuesta. Un reintento con un nuevo ID de solicitud puede entonces crear otro navegador para el mismo trabajo. El trabajo debe recuperar primero la intención original. Nstdata Cloud Browser.
Compare tres tiempos de espera. La solicitud de creación puede agotarse antes de devolver un ID de sesión. La conexión puede caerse después de que una sesión existente esté lista. Una acción de sitio web puede agotarse después de enviar un formulario. Estos eventos implican diferentes efectos anteriores. Cada uno necesita una referencia duradera y una regla para decidir si es seguro proceder. Consulte la guía del ciclo de vida de sesión del Cloud Browser.
¿Qué operaciones puedes reintentar de forma segura?
Reintenta una operación cuando tengas una forma estable de identificar el efecto previsto y suficiente evidencia de que repetirla está permitido. La guía del Cloud Browser de Nstdata instruye a los llamadores a mantener el mismo y parámetros de creación idénticos para un reintento de la misma intención de creación. Usa un nuevo ID para una nueva sesión intencional o configuración cambiada. La semántica del método HTTP por sí sola no otorga a tu aplicación permiso para repetir una escritura. .
Reintentar la misma intención de creación dentro de la política
Sesión conocida pero no lista
ID de sesión original
Consultar el mismo estado dentro de un plazo
CDP desconectado
Sesión lista original
Emitir nuevas credenciales de automatización y volver a adjuntar
Resultado de escritura en el sitio web poco claro
Recibo de la aplicación o referencia comercial
Verificar estado duradero antes de repetir cualquier cosa
Estado de parada poco claro
ID de sesión original
Verificar estado y completar limpieza
Trabajador falló
Registro de propietario durable e IDs almacenados
Conciliar el trabajo original antes de comenzar un nuevo trabajo
El camino de reinicio debe recuperar el estado del almacenamiento duradero. Un ID aleatorio mantenido en memoria solo funciona hasta que finaliza el proceso actual. Persistir la intención del trabajo y la intención de creación del navegador antes de enviar la solicitud. Vincula ambos al alcance del espacio de trabajo. Para una explicación de cómo adjuntarse a un navegador ya en funcionamiento, consulte conexión CDP de Playwright.
¿Cómo implementas un reintento de creación idempotente?
Persistir los bytes de la solicitud, reintentar solo resultados transitorios bien definidos y guardar el ID de sesión devuelto antes de proceder a las operaciones de página. El ejemplo mantiene el camino feliz cerca del camino de recuperación. Utiliza los puntos finales actuales de Nstdata y una pequeña política de aplicación configurable. Tutorial de la API de Automatización de Navegadores.
Paso 1. Determinar las opciones de sesión permitidas
Leer GET /api/v1/cloud-browser/sessions/options en el espacio de trabajo deseado. Elegir valores permitidos de clase de recurso y proxy y una duración permitida. Construir un cuerpo de creación siguiendo el esquema actual. Un UUIDv4 requestId debe ser estable para esta intención. Una respuesta de creación puede contener advertencias de configuración, por lo que se debe inspeccionar la configuración efectiva antes de confiar en la sesión para una prueba sensible al entorno.
Paso 2. Guardar la solicitud prevista antes de enviarla
Escribir el cuerpo de creación serializado en un registro de trabajo protegido o en un archivo como request.json para el ejemplo. Mantener el cuerpo original a través de reinicios de trabajadores. Vincular el registro al espacio de trabajo correcto y usar una restricción de base de datos o arrendamiento para evitar que propietarios paralelos compitan por un trabajo. Almacenar solo configuraciones de experimento aprobadas. Una URL de proxy personalizada puede contener credenciales, por lo que se debe utilizar un almacenamiento secreto apropiado si tu aplicación elige ese camino.
Paso 3. Ejecutar el trabajador de reintento acotado
Utiliza Node.js 22.12 o superior. Guarda retry.mjs y retry-demo.mjs, establece NSTDATA_API_KEY y cualquier NSTDATA_TEAM_ID aplicable, y ejecuta node retry-demo.mjs request.json. Esta rama gestionada requiere tu espacio de trabajo autorizado de Cloud Browser. La función de reintento se probó con un transporte sintético que pierde la primera respuesta, devuelve una sesión en la segunda y compara los dos cuerpos byte por byte.
import{ setTimeout as wait }from'node:timers/promises';exportasyncfunctionresumeCreate(bodyBytes, send, delay = wait){const intended =JSON.parse(bodyBytes);if(!/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(intended.requestId)){thrownewError('Expected a saved UUIDv4 requestId');}for(let attempt =0; attempt <3; attempt++){let response;try{ response =awaitsend(bodyBytes);}catch{if(attempt ===2)break;awaitdelay(500*2** attempt);continue;}if(!response.ok){const retryable =[429,503].includes(response.status);if(!retryable)thrownewError('Inspect create HTTP '+ response.status);if(attempt ===2)break;const header = response.headers.get('retry-after');const hint = header &&/^\d+$/.test(header)?Number(header)*1000: header ?Math.max(0,Date.parse(header)-Date.now()):0;if(hint >10_000)break;// Leave the saved intent for a later worker.awaitdelay(Math.max(500*2** attempt, hint ||0));continue;}const result =await response.json().catch(()=>null);if(result?.err !==true&& result?.success !==false&&typeof result?.data?.sessionId ==='string'&& result.data.sessionId){return result.data.sessionId;}break;}thrownewError('Create outcome unresolved. Retain the original requestId and payload.');}
La muestra repite una falla de transporte, HTTP 429 o HTTP 503 dentro de su propia política limitada. Espera al menos la pista de Retry-After disponible si esa pista se ajusta al presupuesto del trabajador. Si el servicio solicita una espera más larga, el trabajador deja la intención original pendiente para otro intento permitido. Para producción, distribuye a los clientes con jitter y aplica la capacidad de la cola. Orientación de MDN para clientes limitados por tasa.
Paso 4. Reconciliar errores que requieren una decisión
Trata los errores de validación y autorización como problemas de configuración. En HTTP 400, inspecciona el campo inválido contra las opciones actuales y crea una nueva intención si la configuración corregida difiere. En 401, 403 o 470, verifica el tipo de clave y la selección de equipo. En 409, inspecciona la operación original y el estado de sesión donde sea posible. Guarda el resultado y deja la solicitud protegida intacta si el resultado sigue siendo incierto.
Paso 5. Confirmar la preparación del navegador y el resultado comercial
Guarda sessionId e inspecciona la sesión original. Solicita credenciales de automatización solo cuando la sesión esté lista. Antes de ejecutar una acción, verifica la identidad de la página, el origen previsto y el estado actual de la aplicación. Si el trabajador se está reanudando después de un desconexión, verifica si una acción previa del sitio web ya tuvo efecto. La guía de depuración del navegador en vivo explica cómo inspeccionar la página y el contexto de la solicitud.
Paso 6. Reconciliar el cierre
Detén la sesión original e inspecciónala hasta que esté ended, o sigue tu política de tiempo de espera y traspaso de operador. Un cliente desconectado y una tarea exitosa son separadas de un navegador gestionado detenido. Si el controlador se bloqueó con solo el ID de solicitud registrado, investiga esa creación original antes de asumir que nunca se ejecutó.
¿Cómo deberías probar la recuperación de trabajos en el navegador?
Simular un resultado de creación ambiguo y verificar que un trabajador reiniciado lea los mismos bytes antes de enviar nuevamente. Después de la respuesta sintética exitosa, afirmar que su ID se almacena contra el trabajo empresarial previsto. Simular un error permanente y confirmar que el trabajador se detiene después de la primera respuesta. Simular un límite de tasa y verificar la demora elegida. Estas pruebas miden el comportamiento de solicitudes y programadores sin gastar tiempo de ejecución en el navegador.
Pruebe la acción de la aplicación por separado. En un entorno de prueba autorizado, cree un registro con una referencia sintética, interrumpa al cliente después del clic y confirme que la recuperación puede encontrar el recibo sin otra escritura exitosa. Luego, simule una operación que nunca llegó al backend y verifique la política acordada para reintentos. Un reintento de prueba de Playwright puede volver a ejecutar el cuerpo de la prueba, lo que importa cuando una prueba crea estado. Guía de reintentos de Playwright.
¿Cómo comparten múltiples trabajadores una política de recuperación?
Varios trabajadores pueden compartir una política de recuperación reclamando un trabajo durable antes de actuar sobre su intención de creación. Un propietario lee o escribe la intención y registra el ID de sesión devuelto. Un propietario posterior verifica el progreso previo antes de crear algo. Una reclamación a la base de datos o un arrendamiento de cola durable pueden serializar esta decisión. El archivo de muestra representa una intención persistida y no proporciona programación concurrente.
Para una prueba de reinicio escalonada, interrumpa al trabajador después de que su llamada de creación comience, inicie un nuevo trabajador contra el mismo registro y compare lo que envía. Mantenga la identidad original del trabajo y confirme que la limpieza utiliza la sesión devuelta. Si un resultado de recurso definitivo no está disponible, marque el trabajo para reconciliación en lugar de permitir un ciclo ilimitado de trabajos de reemplazo.
¿Cómo se ajusta Nstdata Cloud Browser a este diseño de recuperación?
Nstdata Cloud Browser proporciona navegadores en la nube gestionados para automatización de navegadores y agentes de IA. Sus puntos finales de ciclo de vida dan a un trabajador un camino para inspeccionar el navegador que creó y recuperarse después de una interrupción. Las opciones de proxy integradas pertenecen a la configuración de sesión guardada, por lo que un reintento preserva la elección de salida para la misma intención. Live View ayuda a los operadores autorizados a investigar cuando un trabajador no puede decidir a partir del estado estructurado. La aplicación sigue siendo responsable de la propiedad durable y de validar la acción empresarial.
Identidad de creación. Preserve el ID de solicitud documentado y la carga útil para la misma creación prevista.
Estado de sesión explícito. Sondee la preparación, mantenga un ID de sesión conocido y requiera confirmación de apagado separado.
Visibilidad del operador. Inspeccione el estado original cuando el diagnóstico requiera observar la página gestionada o revisar los registros disponibles.
Reconciliación de uso. Une ejecuciones aceptadas y fallidas al tiempo de ejecución y tráfico observados. Precios de Cloud Browser.
Registre el ID del trabajo, el espacio de trabajo, el ID de solicitud original, el ID de sesión conocido, la última etapa completada, el código de estado seguro y la próxima acción de reconciliación. Mantenga el registro de creación protegido en almacenamiento durable y suprima las credenciales de acceso de la salida operativa. Haga un seguimiento de las presentaciones no resueltas y las detenciones no confirmadas para que el siguiente propietario sepa por dónde empezar. Pruebe la recuperación con un caso deliberadamente interrumpido antes de agregar reintentos no atendidos.
Q: ¿Debería cada reintento usar un nuevo ID de solicitud?
Reuse el ID original y la carga útil de creación idéntica para la misma intención de creación. Genere un nuevo ID cuando inicie intencionalmente otra sesión o cambie la configuración.
Q: ¿Una solicitud HTTP fallida prueba que no se creó ningún navegador?
Un error de transporte puede dejar el resultado incierto. Reconciliar la intención de creación almacenada antes de iniciar otro trabajo.
Q: ¿La idempotencia del ciclo de vida del navegador previene envíos duplicados de sitios web?
La acción del sitio web necesita su propia referencia durable y verificación de resultado. Confirme el estado empresarial antes de cualquier intento de repetición.
Q: ¿Puedo reconectarme cuando el navegador ya terminó?
Verifique la sesión original. Un navegador cerrado requiere una nueva sesión deliberada si el flujo de trabajo debe ejecutarse nuevamente.
Q: ¿Qué pasa si se agota un pedido de detención?
Inspeccione el ID de sesión original. Mantenga la limpieza pendiente hasta que se haya confirmado el estado terminal.
Cree casos de prueba que aíslen las preferencias de enrutamiento y navegador. Utilice señales del navegador y resultados visibles de la aplicación para explicar las diferencias de configuración regional en una sesión de Cloud Browser.
Marcus Chen
Nov. 19th 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.