明示的なコンテナでテストの決定性を保つ。
多くのテストシナリオは、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 の動作を検証してください。