明示的なコンテナでテストの決定性を保つ。

多くのテストシナリオは、read、invalidate、refresh、listen、インスタンス単位の override といった ProviderContainer API にそのまま対応します。

テスト方針

純粋なコンテナテストと Widget統合テストを分けると見通しが良くなります。

Dartのみ

ProviderContainer を直接使い read/invalidate/refresh を検証

オーバーライド

Providerインスタンス単位で overrideWith / overrideWithValue

ウィジェットのテスト

外部注入コンテナを使う場合は明示 dispose

ヒント

ProviderContainer.listen は fireImmediately: true を付けない限り初期値を流しません。

実行コマンドとチェック項目

テストスイート全体を実行し、autoDispose のケースで未処理のタイマーが残らないことを確認します。

コマンド

flutter test

チェックリスト

- 外部注入した ProviderContainer は tearDown で必ず dispose する。
- listener の検証で初期値が必要な場合は fireImmediately: true を使う。
- autoDispose テストでは fake time を autoDisposeDelay より先へ進める。

例: 引数ごとの override

family 相当の Provider はファクトリ関数が返すインスタンス単位で override します。

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();
このパターンは miniriverpod リポジトリの README および upstream テストを反映しています。
Widgetテストではアンマウント後に外部コンテナを dispose してください。
fake_async を使い、autoDispose の遅延と keepAlive の動作を検証してください。

次のステップ

APIリファレンス

ProviderContainer、Ref、AsyncValue、mutation API のシグネチャをすぐに確認できます。

APIリファレンスを開く

概要に戻る

miniriverpod 全体の導線に戻ります。

概要を開く