fxConflate

Una ejecución asíncrona a la vez; lo que llegue entretanto se colapsa en su valor más nuevo, que es el que se ejecuta después.

Conflated<T> fxConflate<T>(FutureOr<void> Function(T value) run, {void Function(Object error, StackTrace stackTrace)? onError}) class Conflated<T> { void call(T value); // run now, or hold as the next value bool get isRunning; bool get isPending; // a value is waiting for the run in flight Future<void> get idle; // nothing running, nothing waiting void cancel(); // drop the waiting value }

Lección

Una barra de reproducción de vídeo llama a seekTo en cada tic del arrastre, pero un seek tarda más que un tic. Esperar cada uno por turno acumula una cola de seeks obsoletos; lanzarlos todos a la vez deja que uno antiguo termine el último y gane. Lo que la barra quiere decir es «ve a donde esté el control ahora», y fxConflate(run) es justo eso: la primera llamada arranca de inmediato; una llamada que llega mientras hay una ejecución en curso se retiene, y una llamada más nueva la sustituye; cuando la ejecución termina, se ejecuta el valor retenido — el más nuevo. Todo lo intermedio se descarta.

Nunca espera a que todo se calme (eso es fxDebounce) y nunca abandona la ejecución en curso (eso es switchLatest en la capa de eventos) — un Future no se puede cancelar, así que el comportamiento honesto es dejarlo terminar y seguir adelante. .isRunning y .isPending describen el estado, .idle se completa en cuanto no hay nada ejecutándose ni nada esperando, y .cancel() descarta el valor retenido.

Un error lanzado por run va a onError, o a la zona actual cuando no lo hay, y no detiene la siguiente ejecución — una sincronización fallida no debería bloquear la siguiente. Extensión de fxdart (sin contraparte en FxTS), inspirada en el conflate de Kotlin Flow.

Demo 1 · Una barra que va más rápido que su seek

Demo 2 · Estado, errores e idle

Pruébalo tú

Ejercicio: renderiza solo el primer valor del slider y el más nuevo.

Relacionado: fxDebounce — espera a que paren las llamadas · fxThrottle — como mucho una vez por ventana · switchLatest — la forma con streams, que abandona la ejecución antigua · concurrentPool — muchas ejecuciones, acotadas