跨平台开发 / 系统课时
用 expect 验证函数返回值
用 expect 验证函数返回值
单元测试最直接的价值,是把“给定输入时应该得到什么结果”写成可重复执行的断言。本节用 expect 测试一个运费函数,重点掌握准备、执行、验证三个阶段,并让失败信息能直接指向业务规则。
学习目标
- 用
expect(actual, matcher)验证函数返回值。 - 按准备、执行、验证组织单元测试,减少测试中的无关逻辑。
- 为正常路径、边界值和非法输入选择必要断言。
expect 在验证什么
package:test/test.dart 提供的 expect 接收实际值和期望 Matcher。最简单的返回值测试可以写成 expect(result, 0);这里的 0 会按等值条件进行匹配,因此测试表达的是“结果必须等于 0”。
单元测试最好只验证一个清晰的业务行为。若一个测试同时准备大量对象、执行多个动作,再检查十几个结果,失败时很难判断是哪条规则被破坏。对纯函数和无副作用业务方法,输入与输出通常就是最稳定的测试边界。
用准备、执行、验证组织测试
下面假设项目已经把 test 包加入 dev_dependencies。将代码保存为 test/shipping_fee_test.dart,这是一个可由 Dart 测试运行器直接执行的完整测试文件。
import 'package:test/test.dart';
int shippingFee({required int subtotal, required bool vip}) {
if (subtotal < 0) {
throw ArgumentError.value(subtotal, 'subtotal', 'must be >= 0');
}
if (subtotal >= 200) {
return 0;
}
return vip ? 5 : 12;
}
void main() {
group('shippingFee', () {
test('orders from 200 are free shipping', () {
// Arrange:只准备本次规则需要的输入。
const subtotal = 200;
// Act:执行一次被测行为。
final fee = shippingFee(subtotal: subtotal, vip: false);
// Assert:只验证本测试关心的结果。
expect(fee, 0);
});
test('vip pays reduced shipping below threshold', () {
final fee = shippingFee(subtotal: 120, vip: true);
expect(fee, 5);
});
test('negative subtotal is rejected', () {
expect(
() => shippingFee(subtotal: -1, vip: false),
throwsArgumentError,
);
});
});
}预期输出
<TIME> +3: All tests passed!在项目根目录执行 dart test test/shipping_fee_test.dart 即可得到等价结果;<TIME> 是测试运行耗时,实际值会随环境变化。
断言边界而不是堆测试数量
返回值测试通常至少考虑三类输入:典型值、规则边界和非法值。上例中的 200 是免运费阈值,因此比再测试多个大于 200 的数字更有价值;负数则验证函数是否拒绝无效业务输入。
不要为了覆盖数字而重复编写只改一个输入的测试。更重要的是让每个用例对应一条能说清楚的规则,并让测试名描述行为,而不是写成 test1、case2。当业务规则变化时,这样的测试也更容易判断应该修改实现还是修改期望。
让失败信息保持可读
expect 失败时会展示期望条件和实际值,因此测试代码通常不需要自己打印调试文本。若断言复杂到必须写大量条件判断才能比较结果,往往意味着应该改用更合适的 Matcher,而不是在测试里重新实现一套判断逻辑。
对函数返回值,优先让测试保持“输入明确、执行一次、断言直接”。这样测试既能充当回归保护,也能成为业务规则的可执行说明。