Halte Tests mit expliziten Containern deterministisch.

Die meisten Testszenarien lassen sich direkt auf ProviderContainer-APIs abbilden: read, invalidate, refresh, listen und Overrides pro Provider-Instanz.

Test Strategy

Teile Tests in reine Container-Tests und Widget-Integrationstests auf.

Pure Dart

Verwende ProviderContainer direkt für read/invalidate/refresh-Assertions

Overrides

Überschreibe pro Provider-Instanz mit overrideWith / overrideWithValue

Widget tests

Injiziere den externen Container und entsorge ihn explizit

Tip

ProviderContainer.listen gibt den Anfangswert nicht aus, außer fireImmediately: true ist angegeben.

Testbefehl und Checkliste

Führe die vollständige Suite aus und prüfe, dass es in autoDispose-Szenarien keine hängenden Timer-Leaks gibt.

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.

Beispiel: Override pro Argument

Familienähnliche Provider werden pro Instanz überschrieben, die aus deiner Factory-Funktion erzeugt wird.

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();
Dieses Muster spiegelt die README und die Upstream-Tests im miniriverpod-Repository wider.
Widget-Tests sollten Widgets vor dem Entsorgen externer Container unmounten.
Verwende fake_async, um autoDispose-Verzögerungen und das keepAlive-Verhalten zu prüfen.

Nächste Schritte

API Reference

Öffne Kurzsignaturen für ProviderContainer, Ref, AsyncValue und Mutation-APIs.

Open API Reference

Back to Overview

Zurück zur vollständigen Dokumentationskarte von miniriverpod.

Open Overview