ProviderDisposedException class final

Thrown when a FutureProvider or StreamProvider is disposed before it has emitted its first value.

This is a normal lifecycle event — it occurs when an autoDispose provider is no longer listened to (e.g. due to navigation) while it is still loading. It is not a programming error.

ProviderObserver.providerDidFail will not be called for this exception.

If a downstream provider awaits a disposed provider's FutureProvider.future, it will receive this exception. You can catch it to treat disposal as a no-op rather than an error:

final dependentProvider = FutureProvider.autoDispose<String>((ref) async {
  try {
    final value = await ref.watch(myProvider.future);
    return 'Got $value';
  } on ProviderDisposedException {
    // Upstream disposed before completing — this is expected.
    return '';
  }
});