跨平台开发 / 系统课时

用 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 测试运行器直接执行的完整测试文件。

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,
      );
    });
  });
}

预期输出

text
<TIME> +3: All tests passed!

在项目根目录执行 dart test test/shipping_fee_test.dart 即可得到等价结果;<TIME> 是测试运行耗时,实际值会随环境变化。

断言边界而不是堆测试数量

返回值测试通常至少考虑三类输入:典型值、规则边界和非法值。上例中的 200 是免运费阈值,因此比再测试多个大于 200 的数字更有价值;负数则验证函数是否拒绝无效业务输入。

不要为了覆盖数字而重复编写只改一个输入的测试。更重要的是让每个用例对应一条能说清楚的规则,并让测试名描述行为,而不是写成 test1、case2。当业务规则变化时,这样的测试也更容易判断应该修改实现还是修改期望。

让失败信息保持可读

expect 失败时会展示期望条件和实际值,因此测试代码通常不需要自己打印调试文本。若断言复杂到必须写大量条件判断才能比较结果,往往意味着应该改用更合适的 Matcher,而不是在测试里重新实现一套判断逻辑。

对函数返回值,优先让测试保持“输入明确、执行一次、断言直接”。这样测试既能充当回归保护,也能成为业务规则的可执行说明。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 expect 验证函数返回值

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

登录哪都通