跨平台开发 / 系统课时

验证关键调用次数与参数

验证关键调用次数与参数

当代码的正确性取决于“是否真的保存、发送或提交”时,只检查返回值往往不够。本节用 Dart 的 Mocktail 验证协作对象的调用次数与关键参数,并说明什么时候该验证一次调用、禁止调用,以及如何避免把断言写得过细。

学习目标

  • 使用 verify 检查协作方法的参数和调用次数
  • 使用 verifyNever 表达“不应发生”的副作用
  • 判断哪些交互值得验证,避免无意义地检查每一次内部调用

为什么返回值不足以证明副作用发生

假设结账方法返回成功,但实现忘了发送收据。只断言返回值时,测试仍可能通过。对邮件发送、支付扣款、消息发布、数据持久化这类协作边界,测试需要观察“调用是否发生”。

交互验证最适合回答三个问题:调用了谁、传了什么关键参数、发生了几次。尤其是扣款、提交订单等非幂等操作,called(1) 可以直接保护“不能重复执行”的约束。

用 Mocktail 验证参数和次数

下面的完整测试定义了一个收据网关,并让 CheckoutService 在结账后调用它。项目需要在开发依赖中包含 test 与 mocktail。

dart
import 'package:mocktail/mocktail.dart';
import 'package:test/test.dart';

abstract interface class ReceiptGateway {
  Future<void> sendReceipt({
    required String email,
    required int orderId,
  });
}

class MockReceiptGateway extends Mock implements ReceiptGateway {}

class CheckoutService {
  CheckoutService(this.gateway);

  final ReceiptGateway gateway;

  Future<void> checkout({
    required int orderId,
    required String email,
  }) async {
    // 这里省略订单计算,只保留本节关注的协作边界。
    await gateway.sendReceipt(email: email, orderId: orderId);
  }
}

void main() {
  test('发送收据时只调用一次且参数正确', () async {
    final gateway = MockReceiptGateway();
    final service = CheckoutService(gateway);

    when(
      () => gateway.sendReceipt(
        email: 'buyer@example.com',
        orderId: 42,
      ),
    ).thenAnswer((_) async {});

    await service.checkout(
      orderId: 42,
      email: 'buyer@example.com',
    );

    verify(
      () => gateway.sendReceipt(
        email: 'buyer@example.com',
        orderId: 42,
      ),
    ).called(1);

    verifyNever(
      () => gateway.sendReceipt(
        email: 'other@example.com',
        orderId: 42,
      ),
    );
  });
}

预期结果:测试代码能够被 Dart 测试运行器加载;一次真实协作会同时满足正确参数、调用一次和错误邮箱未调用这三个断言。

保存为 test/checkout_service_test.dart 后执行:

bash
dart test test/checkout_service_test.dart --reporter expanded

预期输出:

text
<TIME> +0: loading test/checkout_service_test.dart
<TIME> +0: 发送收据时只调用一次且参数正确
<TIME> +1: All tests passed!

其中 <TIME> 是测试运行时产生的耗时显示,实际值会不同。

次数断言要对应业务约束

不是每个方法都值得加 called(1)。如果“调用一次”本身没有业务意义,测试会被无关重构牵着走。次数验证通常优先放在重复执行会产生风险的操作上,例如扣款、发券、发布消息和写入外部系统。

verifyNever 适合表达明确的禁止路径,例如校验失败时不得扣款。不要用 verify(...).called(0) 代替它。还要注意,Mocktail 中已经被 verify 匹配过的调用会从后续验证中排除,因此不要对同一次交互反复执行相同验证。

只验证稳定的协作契约

参数断言也应聚焦业务关键值。订单 ID、金额、收件人地址通常值得检查;日志文本、内部 DTO 的临时字段或某个辅助方法是否被调用,往往只是实现细节。

如果一次重构没有改变对外行为,却因为大量内部 verify 导致测试失败,说明交互断言可能越界了。保留真正代表副作用契约的验证,其他逻辑优先通过返回值、状态变化或输出数据来证明。

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

目录与阅读设置

阅读设置

17

记录一个想法

验证关键调用次数与参数

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

登录哪都通