fxFoldRaise

Ejecuta un bloque en un ámbito Raise<E> nuevo y pliega lo que ocurra — un valor, un error elevado o una excepción lanzada — en un único tipo de resultado.

B fxFoldRaise<E, A, B>(A Function(Raise<E> r) block, {required B Function(E error) onRaise, required B Function(A value) onValue, B Function(Object thrown, StackTrace stackTrace)? onThrow}) Future<B> fxFoldRaiseAsync<E, A, B>(FutureOr<A> Function(Raise<E> r) block, {required FutureOr<B> Function(E error) onRaise, required FutureOr<B> Function(A value) onValue, FutureOr<B> Function(Object thrown, StackTrace stackTrace)? onThrow})

Lección

fxEither convierte un bloque raise en un Either; fxNullable lo convierte en un T?. Ambos son una sola llamada a fxFoldRaise, la única primitiva de la que derivan todos los constructores — el port del fold de Arrow. Ejecuta block con un ámbito nuevo r y despacha según cómo terminó el bloque:

Úsalo cuando en la frontera no quieres ni un Either ni un T? — una cadena de estado, una respuesta HTTP, un record, un tipo sealed propio — y de lo contrario construirías un Either solo para hacerle switch en la línea siguiente. También es la forma de escribir tu propio constructor: fxEither es fxFoldRaise con un onRaise que construye un Left y un onValue que construye un Right, y nada más. onThrow es la forma de tres cláusulas que fxEitherCatching y r.recover transmiten; la señal de raise en sí nunca se le entrega.

fxFoldRaiseAsync es el gemelo asíncrono: el bloque y cada manejador pueden esperar con await, y rige la misma regla que en fxEitherAsync — eleva solo dentro de la cadena esperada. El ámbito se cierra cuando el plegado retorna, así que un pipeline perezoso que elevaría más tarde debe materializarse dentro del bloque. Se llama fxFoldRaise porque fxFold ya existe.

Demo 1 · Tres resultados, un tipo de resultado

Demo 2 · Un constructor propio, anidamiento & asíncrono

Pruébalo tú

Ejercicio: sáltate el Either intermedio y pliega el ámbito directamente en el mensaje.

Relacionado: fxEither & el ámbito Raise — el constructor construido sobre él · fxNullable — el constructor sin información, también un solo plegado · Either — fold sobre un valor que ya tienes · errores tipados — guía completa