跨平台开发 / 系统课时
测试 Notifier 的状态变更
测试 Notifier 的状态变更
Notifier 的价值在于根据用户操作和外部数据改变应用状态。测试 Notifier 时,需要关注调用业务方法前后的状态差异,而不是只检查方法是否执行。本篇将通过 ProviderContainer 验证状态更新流程。
学习目标
- 理解 Notifier 测试应该关注哪些状态变化。
- 学会创建测试容器并读取 Notifier 状态。
- 掌握对业务方法执行结果进行断言的方法。
测试状态变化的核心思路
Notifier 测试通常包含三个阶段:创建测试环境、执行状态操作、检查最终状态。
测试环境中可以结合 Provider overrides 提供稳定依赖,然后读取 Notifier 当前状态。调用方法后,再读取新的状态并进行比较。
创建可测试的 Notifier
下面示例实现一个简单计数状态。实际项目中的 Notifier 通常会调用 Repository,但测试结构保持一致。
dart
import 'package:flutter_riverpod/flutter_riverpod.dart';
class CounterNotifier extends Notifier<int> {
@override
int build() => 0;
void increment() {
state++;
}
}
final counterProvider = NotifierProvider<CounterNotifier, int>(
CounterNotifier.new,
);
void main() {
final container = ProviderContainer();
final before = container.read(counterProvider);
container.read(counterProvider.notifier).increment();
final after = container.read(counterProvider);
print('$before -> $after');
container.dispose();
}预期输出
text
0 -> 1测试重点不是 increment 方法有没有被调用,而是状态是否从初始值正确变化到目标值。
验证复杂业务状态
实际业务中,Notifier 状态通常包含加载状态、数据和错误信息。例如提交表单后,状态可能经历以下变化:
| 阶段 | 状态 | 验证重点 |
|---|---|---|
| 初始 | 空数据 | 默认值正确 |
| 执行请求 | 加载中 | 方法触发成功 |
| 请求成功 | 有数据 | 数据写入正确 |
| 请求失败 | 错误信息 | 异常处理正确 |
测试时应针对业务状态变化设计断言,避免只验证内部变量。
测试中的常见问题
如果测试读取状态后没有变化,通常需要检查以下问题:
- 是否读取了正确的 Provider。
- 是否调用了 Notifier 实例的方法,而不是重新创建对象。
- 异步逻辑是否等待 Future 完成。
- 依赖 Provider 是否已经通过 overrides 替换。
对于异步 Notifier,测试应等待状态更新完成后再断言,避免因为执行时序导致偶发失败。
设计容易测试的 Notifier
好的状态管理设计会让 Notifier 只负责状态编排,把网络、存储等操作放入 Provider 依赖中。这样测试时可以替换依赖,并集中验证状态迁移是否符合业务规则。
当一个 Notifier 需要大量 Mock 内部方法才能测试时,通常说明职责划分过于紧密,需要重新拆分依赖边界。
按自己的节奏,确认真正理解。