跨平台开发 / 系统课时

按顺序断言 Stream 事件

按顺序断言 Stream 事件

测试 Stream 不能只看“最终有没有值”,还要验证事件出现的顺序、数量、正常结束以及错误事件的位置。本篇使用 package:test 的流匹配器,把一条事件流当成可验证的事件协议,并避免测试提前结束或漏掉终止事件。

学习目标

  • 使用 emitsInOrder 按顺序断言多个 Stream 事件
  • 用 emitsDone 和 emitsError 验证结束与错误
  • 避免未等待异步断言、重复订阅等常见测试问题

用顺序匹配器描述事件协议

emitsInOrder 接收一组值或 Matcher,并依次消费流中的事件。它比先把流转成列表再比较更贴近真实流行为,因为正常结束、错误事件也能成为断言的一部分。

异步流断言应使用 expectLater 并 await。这样测试会等待匹配过程完成;如果漏掉 await,测试函数可能先返回,后续失败就无法稳定归属于当前用例。

完整验证值、结束和错误

下面的测试文件同时覆盖正常事件流和错误事件流。示例假设项目的 dev_dependencies 已包含 test 包。

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

Stream<int> countStream() async* {
  yield 1;
  yield 2;
  yield 3;
}

Stream<int> failingStream() async* {
  yield 1;
  throw StateError('boom');
}

void main() {
  test('按顺序收到三个事件并正常结束', () async {
    await expectLater(
      countStream(),
      emitsInOrder(<Object?>[
        1,
        2,
        3,
        emitsDone,
      ]),
    );
  });

  test('错误事件出现在预期位置并随后结束', () async {
    await expectLater(
      failingStream(),
      emitsInOrder(<Object?>[
        1,
        emitsError(isA<StateError>()),
        emitsDone,
      ]),
    );
  });

  test('顺序断言同时约束事件数量', () async {
    await expectLater(
      Stream<int>.fromIterable(<int>[10, 20]),
      emitsInOrder(<Object?>[
        10,
        20,
        emitsDone,
      ]),
    );
  });
}

把文件保存为 test/stream_order_test.dart 后运行:

bash
dart test test/stream_order_test.dart

预期输出

text
<TIME> +3: All tests passed!

<TIME> 表示测试运行时间,实际值可能不同。不同 reporter 还可能显示每个用例的进度行,但最终应有 3 个测试通过。

为什么要显式断言结束事件

如果只写 emitsInOrder([1, 2, 3]),这组匹配器只关心前三个匹配事件,不够明确地表达“之后不应再有事件”。把 emitsDone 放在最后,相当于把流关闭也写进协议:多发一个值、永不结束或在结束前抛错,都会让测试失败。

错误同样是事件序列的一部分。emitsError(isA<StateError>()) 既验证错误发生在正确位置,也避免把测试绑死到完整错误文本;只有业务确实依赖消息内容时,才需要进一步匹配错误对象的字段或字符串。

避免让流测试变得不稳定

不要对同一个单订阅 Stream 连续执行两次独立的 expectLater,第一次断言已经建立订阅,第二次可能直接触发“已监听”错误。若要验证多个条件,应把它们合并进同一个 emitsInOrder,或为每个测试重新创建一条流。

对于广播流,还要注意“先发事件、后订阅”会丢失早期事件。测试中最好在创建断言后再触发生产逻辑,或让被测对象在订阅建立后才开始发送。这样断言验证的是事件协议本身,而不是调度时机造成的偶然结果。

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

目录与阅读设置

阅读设置

17

记录一个想法

按顺序断言 Stream 事件

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

登录哪都通