Mantieni i test deterministici con container espliciti.

La maggior parte degli scenari di test si mappa direttamente alle API di ProviderContainer: read, invalidate, refresh, listen e override per istanza di provider.

Test Strategy

Dividi i test in test puri di container e test di integrazione dei widget.

Pure Dart

Usa ProviderContainer direttamente per le asserzioni read/invalidate/refresh

Overrides

Sovrascrivi per istanza di provider con overrideWith / overrideWithValue

Widget tests

Inietta il container esterno e disporne esplicitamente

Tip

ProviderContainer.listen non emette il valore iniziale a meno che non sia specificato fireImmediately: true.

Comando di test e checklist

Esegui l intera suite e verifica che non ci siano perdite di timer pendenti negli scenari autoDispose.

Command

Checklist

- Dispose externally injected ProviderContainer in tearDown.
- Use fireImmediately: true when your listener assertions need initial state.
- For autoDispose tests, advance fake time beyond autoDisposeDelay.

Esempio: override per argomento

I provider simili a famiglie vengono sovrascritti per istanza creata dalla tua funzione factory.

class ProductById extends Provider<Product> {
  ProductById(this.id) : super.args((id,));
  final String id;

  @override
  Product build(ref) {
    final repo = ref.watch(productRepoProvider);
    return repo.fetch(id);
  }
}

final container = ProviderContainer(
  overrides: [
    productByIdProvider('a').overrideWithValue(const Product(id: 'a', name: 'stub')),
  ],
);

// assert and cleanup
container.dispose();
Questo pattern rispecchia il README e i test upstream del repository miniriverpod.
I test dei widget dovrebbero smontare i widget prima di disporre i container esterni.
Usa fake_async per validare i ritardi di autoDispose e il comportamento keepAlive.

Prossimi passi

API Reference

Apri le firme rapide per ProviderContainer, Ref, AsyncValue e le API di mutation.

Open API Reference

Back to Overview

Torna alla mappa completa della documentazione di miniriverpod.

Open Overview