fxMapCatching

Un map en el que el fallo de cada elemento se sustituye por un valor — una fila mala nunca termina la iteración.

Iterable<R> fxMapCatching<A, R>(R Function(A a) f, R Function(Object error, StackTrace stackTrace) onError, Iterable<A> iterable) FxAsyncIterable<R> fxMapCatchingAsync<A, R>(FutureOr<R> Function(A a) f, FutureOr<R> Function(Object error, StackTrace stackTrace) onError, FxAsyncIterable<A> iterable) Fx<R> Fx<T>.mapCatching<R>(R Function(T a) f, R Function(Object error, StackTrace stackTrace) onError) // chain (sync) FxAsync<R> FxAsync<T>.mapCatching<R>(FutureOr<R> Function(T a) f, FutureOr<R> Function(Object error, StackTrace stackTrace) onError) // chain (async)

Lección

Un map cuyo callback lanza una excepción termina todo el pipeline en ese elemento: una fila mal formada entre diez mil y obtienes una excepción, no nueve mil novecientos noventa y nueve resultados. mapCatching(f, onError) ejecuta f sobre cada elemento y, cuando lanza, entrega el error y su stack trace a onError y emite lo que este devuelve en el lugar del elemento fallido. El siguiente elemento se mapea como si nada hubiera pasado. Sigue siendo perezoso, y en Fx se queda en la cadena síncrona — no hay nada que esperar.

Está al lado de mapRetry, y los dos son las dos respuestas a un elemento que falla: mapRetry lo ejecuta otra vez; mapCatching se rinde y lo sustituye. La forma asíncrona, fxMapCatchingAsync / fxAsync(…).mapCatching, permite que tanto f como onError esperen con await, y está construida sobre el fxMapAsync seguro en paralelo, así que bajo concurrent(n) cada elemento en vuelo se recupera por su cuenta y el orden se conserva. RxDart lo escribe como onErrorReturnWith; en un stream push de fxdart los vecinos son onErrorReturn, que sustituye cada error por un único valor fijo, y attempt, que conserva el error como un Left en lugar de reemplazarlo.

Hay una cosa que nunca se recupera: la señal de raise de la propia biblioteca. Un r.raise(…) — desde un bind, un ensure o un constructor anidado — que atraviesa f se relanza, así que sigue cortocircuitando el bloque fxEither / fxNullable que lo envuelve. Recuperarla convertiría un error tipado en uno perdido. Como con cualquier pipeline perezoso dentro de un bloque raise, materialízalo (toList()) dentro del bloque. Extensión de fxdart (no forma parte de FxTS).

Demo 1 · Una fila mala, recuperada en su sitio

Demo 2 · Asíncrono bajo concurrent, y raise que pasa de largo

Pruébalo tú

Ejercicio: sustituye el bucle try/catch por un solo operador.

Relacionado: retry — ejecuta el elemento otra vez en lugar de sustituirlo · onErrorReturn — la misma idea en un stream push · errores tipados — cuando el fallo debe seguir siendo un valor que puedas inspeccionar