Mantenha os testes determinísticos com contêineres explícitos.
A maioria dos cenários de teste mapeia diretamente para as APIs de ProviderContainer: read, invalidate, refresh, listen e overrides por instância de provider.
Test Strategy
Divida os testes em testes puros de contêiner e testes de integração de widgets.
Pure Dart
Use ProviderContainer diretamente para asserções de read/invalidate/refresh
Overrides
Sobrescreva por instância de provider com overrideWith / overrideWithValue
Widget tests
Injete o contêiner externo e descarte-o explicitamente
Tip
ProviderContainer.listen não emite o valor inicial a menos que fireImmediately: true seja especificado.
Comando de teste e lista de verificação
Execute a suíte completa e verifique que não há vazamentos de temporizadores pendentes em cenários 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.
Exemplo: override por argumento
Providers do tipo família são sobrescritos por instância criada a partir da sua função fábrica.
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();
Próximos passos
API Reference
Abra assinaturas rápidas para ProviderContainer, Ref, AsyncValue e as APIs de mutation.
Open API Reference