FutureProvider

FutureProvider es el equivalente de Provider pero para código asíncrono.

FutureProvider se usa típicamente para:

• realizar y almacenar en caché operaciones asíncronas (como solicitudes de red)
• manejar bien los estados de error/carga de las operaciones asincrónicas
• combinar múltiples valores asíncronos en otro valor

FutureProvider va muy bien cuando se combina con ref.watch. Esta combinación permite la recuperación automática de algunos datos cuando cambian algunas variables, lo que garantiza que siempre tengamos el valor más actualizado.

info

FutureProvider no ofrece una forma de modificar directamente el cálculo después de una interacción del usuario. Está diseñado para resolver casos de uso simples.
Para escenarios más avanzados, considere usar StateNotifierProvider.

Ejemplo de uso: leer un archivo de configuración

FutureProvider puede ser una forma conveniente de exponer un objeto Configuration
creado mediante la lectura de un archivo JSON.

La creación de la configuración se haría con la sintaxis típica de async/await, pero dentro del provider. Usando el sistema de assets de Flutter, esto sería:

@riverpod
Future<Configuration> fetchConfiguration(Ref ref) async {
  final content = json.decode(
    await rootBundle.loadString('assets/configurations.json'),
  ) as Map<String, Object?>;

  return Configuration.fromJson(content);
}

Luego, la interfaz de usuario puede escuchar configuraciones como esta:

Widget build(BuildContext context, WidgetRef ref) {
  final config = ref.watch(fetchConfigurationProvider);

  return switch (config) {
    AsyncError(:final error) => Text('Error: $error'),
    AsyncData(:final value) => Text(value.host),
    _ => const CircularProgressIndicator(),
  };
}

Esto reconstruirá automáticamente la interfaz de usuario cuando se complete el Future. Al mismo tiempo, si varios widgets desean las configuraciones, el asset se decodificará solo una vez.

Como puedes ver, escuchar un FutureProvider dentro de un widget devuelve un AsyncValue, que permite manejar los estados de error/carga.