Håll tester deterministiska med explicita containrar.

De flesta testscenarier mappas direkt till ProviderContainer-API:er: read, invalidate, refresh, listen och overrides per providerinstans.

Open API Reference Read Flutter API

Test Strategy

Dela upp tester i rena container-tester och widgetintegrationstester.

Pure Dart

Använd ProviderContainer direkt för read/invalidate/refresh-asertioner

Overrides

Skriv över per providerinstans med overrideWith / overrideWithValue

Widget tests

Injicera den externa containern och disponera den uttryckligen

Tip

ProviderContainer.listen skickar inte ut det initiala värdet om inte fireImmediately: true anges.

Testkommando och checklista

Kör hela sviten och verifiera att det inte finns några väntande timerläckor i autoDispose-scenarier.

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.

Exempel: override per argument

Familjeliknande providers skrivs över per instans som skapas av din fabriksfunktion.

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();

Det här mönstret speglar README och upstream-testerna i miniriverpod-repositoriet.

Widgettester bör avmontera widgets innan externa containrar släpps.

Använd fake_async för att validera autoDispose-fördröjningar och keepAlive-beteende.

Nasta steg

API Reference

Öppna snabba signaturer för ProviderContainer, Ref, AsyncValue och mutation-API:er.

Open API Reference

Back to Overview

Tillbaka till den fullständiga dokumentationskartan för miniriverpod.

Open Overview