Cloudflare Workflows: eventos en vivo con .subscribe()
Ahora podés suscribirte a los eventos de una instancia de Workflow desde un Worker o vía API, en vez de consultar el estado por polling.
Qué resuelve .subscribe()
Con WorkflowInstance.subscribe() y el endpoint GET /subscribe, tu Worker o cualquier cliente HTTP puede reaccionar a eventos de la instancia y de los steps: intentos, sleeps, waits y rollbacks. Ya no necesitás hacer polling del estado de la instancia para saber qué está pasando.
const instance = await env.MY_WORKFLOW.get("report-123");using subscription = await instance.subscribe();while (true) { const { value, done } = await subscription.next(); if (done) { break; } console.log(value.type, value);}Historial primero, después eventos nuevos
Al suscribirte, primero recibís todo el historial de eventos de la instancia. Una vez que terminó de transmitir esos eventos pasados, la suscripción queda esperando y te va entregando los eventos nuevos a medida que la instancia sigue ejecutándose.
Filtrar eventos o arrancar desde un punto puntual
Podés usar filter para recibir solo determinados tipos de evento, y cursor para arrancar la suscripción desde un evento específico en vez de leer todo el historial desde el principio.
Para qué lo usarías
Las notas mencionan como casos de uso actualizar el estado de un Workflow en dashboards de cara al usuario, mandar notificaciones cuando terminan steps, o disparar trabajo adicional en respuesta a eventos específicos.
Qué te llevas
subscribe() elimina la necesidad de polling para seguir el estado de una instancia de Workflow.
La suscripción entrega primero el historial completo y después sigue con los eventos en tiempo real.
Podés acotar lo que recibís con filter (tipos de evento) o cursor (punto de partida).
Sirve para dashboards en vivo, notificaciones de steps completados y disparo de trabajo derivado de eventos puntuales.
¿Quieres una clase de esto?
Si varias personas lo piden, entra al programa. No hace falta dejar mail ni nombre.