跨平台开发 / 系统课时

测试 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 内部方法才能测试时,通常说明职责划分过于紧密,需要重新拆分依赖边界。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

测试 Notifier 的状态变更

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通