fxRetry

Ejecuta de nuevo un efecto inestable hasta que tenga éxito — hasta attempts veces, con backoff opcional entre fallos.

Future<T> fxRetry<T>(int attempts, FutureOr<T> Function() f, {Duration Function(int failed)? delay, bool Function(Object error)? retryIf, FutureOr<void> Function(Object error, int failed)? onRetry}) FxAsyncIterable<R> fxMapRetryAsync<A, R>(int attempts, FutureOr<R> Function(A a) f, FxAsyncIterable<A> iterable, {Duration Function(int failed)? delay, bool Function(Object error)? retryIf, FutureOr<void> Function(Object error, int failed)? onRetry}) FxAsync<R> Fx<T>.mapRetry<R>(int attempts, FutureOr<R> Function(T a) f, {delay, retryIf, onRetry}) // chain (sync → async) FxAsync<R> FxAsync<T>.mapRetry<R>(int attempts, FutureOr<R> Function(T a) f, {delay, retryIf, onRetry}) // chain (async)

Lección

Los pipelines reales llaman a servicios reales, y los servicios reales fallan de vez en cuando. La respuesta hecha a mano es un bucle for con un try/catch, un contador y un Future.delayed — copiada en cada proyecto, sutilmente distinta cada vez. fxRetry(attempts, f) es ese bucle, una sola vez: ejecuta f, y ante un error vuelve a ejecutarlo, hasta attempts ejecuciones en total; agotado el presupuesto, el último error se relanza con su stack trace original. El hook delay recibe el número de fallos (1, 2, …), así que el backoff es una línea: delay: (failed) => Duration(seconds: failed).

mapRetry(attempts, f) es la misma idea por elemento: un map en el que cada llamada tiene su propio presupuesto de reintentos. Está construido sobre el fxMapAsync seguro en paralelo, así que bajo concurrent(n) cada elemento en curso reintenta de forma independiente — un elemento lento e inestable se reejecuta mientras sus vecinos avanzan sin problema, y el orden se sigue preservando. Para reintentar un pipeline entero, envuelve su terminal: fxRetry(3, () => fxAsync(…).toList()) — el resultado parcial se descarta y el pipeline se reejecuta desde un iterador nuevo.

No todo error merece otra ejecución. retryIf recibe el error y decide: si devuelve false, se relanza al instante — sin espera, sin gastar intentos — así que un timeout se reintenta mientras que un 404 o un error de parseo fallan rápido. onRetry se llama con el error y el número de fallos en cada fallo que sí se va a reintentar, antes de la espera: el sitio para registrarlo, o para cerrar una conexión rota antes de la siguiente ejecución. El fallo final no se notifica ahí; es el error con el que termina la llamada. mapRetry acepta ambos, por elemento.

Extensión de fxdart (sin contraparte en FxTS), inspirada en retry/retryWhen de Rx — rediseñada para el modelo pull, donde «resuscribirse» significa «construir el iterable otra vez». Para un manejo tipado del fallo cuando los reintentos se agotan, pásale el resultado a fxEitherCatching.

Demo 1 · Una petición inestable, con backoff

Demo 2 · mapRetry bajo concurrent

Demo 3 · retryIf y onRetry

Pruébalo tú

Ejercicio: haz que la importación sobreviva a sus filas inestables.

Relacionado: timeout — acota cuánto puede tardar cada pull · concurrent — los reintentos son independientes por elemento en vuelo · errores tipados — cuando el fallo debe ser un valor, no una excepción