跨平台开发 / 系统课时
按 Arrange Act Assert 组织测试
按 Arrange Act Assert 组织测试
编写单元测试时,测试结构是否清晰会直接影响维护成本。本篇介绍 Arrange Act Assert 模式,通过固定测试步骤组织 Flutter 业务逻辑测试,让失败位置和原因更容易定位。
学习目标
- 理解 Arrange Act Assert 三个阶段分别承担的职责
- 使用 AAA 模式编写结构清晰的 Flutter 单元测试
- 根据测试失败位置快速判断业务逻辑问题
为什么需要固定测试结构
业务测试通常包含准备数据、执行行为、验证结果三个过程。如果这些过程混杂在一起,测试代码会随着业务增长变得难以阅读,失败时也很难判断问题来自初始化、执行过程还是断言。
Arrange Act Assert(AAA)是一种常见测试组织方式:
- Arrange:准备测试环境、输入数据和依赖对象
- Act:执行被测试的方法或操作
- Assert:验证执行结果是否符合预期
这种结构不是 Flutter 专属规则,而是一种帮助测试代码表达意图的编排方式。
在 Flutter 单元测试中划分三个阶段
以一个简单的购物车业务为例,测试添加商品后的数量变化。
dart
import 'package:flutter_test/flutter_test.dart';
class Cart {
final List<String> items = [];
void add(String item) {
items.add(item);
}
int get count => items.length;
}
void main() {
test('add item increases cart count', () {
// Arrange:创建被测试对象并准备输入
final cart = Cart();
// Act:执行实际业务操作
cart.add('keyboard');
// Assert:验证业务结果
expect(cart.count, 1);
});
}预期输出
text
00:00 +1: add item increases cart count
All tests passed!测试代码中,每个阶段只有一个职责。当断言失败时,可以快速确认是商品添加逻辑错误,还是测试数据准备不正确。
AAA 模式在复杂业务中的使用
实际项目中,Act 阶段通常是一行调用,但 Arrange 阶段可能需要创建实体、模拟依赖或配置状态。例如测试登录服务时,Arrange 负责准备用户信息和模拟接口响应,Act 调用登录方法,Assert 验证返回结果。
不要把多个业务行为放入同一个 Act 阶段。一个测试最好验证一个主要行为,否则失败时无法快速定位具体原因。
避免 AAA 使用中的常见问题
AAA 并不要求每个测试必须严格写出三个注释,而是要求代码结构体现三个阶段。对于简单断言,额外注释可能反而降低可读性。
常见问题包括:
- 在 Arrange 阶段执行实际业务操作,导致测试准备过程隐藏了被测行为
- 在 Act 阶段调用多个无关方法,让测试目标不明确
- 在 Assert 阶段验证过多无关结果,使失败信息难以分析
一个好的单元测试应该让阅读者在几秒内知道测试输入是什么、执行了什么、期待什么结果。
按自己的节奏,确认真正理解。