跨平台开发 / 系统课时
按顺序断言 Stream 事件
按顺序断言 Stream 事件
测试 Stream 不能只看“最终有没有值”,还要验证事件出现的顺序、数量、正常结束以及错误事件的位置。本篇使用 package:test 的流匹配器,把一条事件流当成可验证的事件协议,并避免测试提前结束或漏掉终止事件。
学习目标
- 使用
emitsInOrder按顺序断言多个 Stream 事件 - 用
emitsDone和emitsError验证结束与错误 - 避免未等待异步断言、重复订阅等常见测试问题
用顺序匹配器描述事件协议
emitsInOrder 接收一组值或 Matcher,并依次消费流中的事件。它比先把流转成列表再比较更贴近真实流行为,因为正常结束、错误事件也能成为断言的一部分。
异步流断言应使用 expectLater 并 await。这样测试会等待匹配过程完成;如果漏掉 await,测试函数可能先返回,后续失败就无法稳定归属于当前用例。
完整验证值、结束和错误
下面的测试文件同时覆盖正常事件流和错误事件流。示例假设项目的 dev_dependencies 已包含 test 包。
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 后运行:
dart test test/stream_order_test.dart预期输出
<TIME> +3: All tests passed!<TIME> 表示测试运行时间,实际值可能不同。不同 reporter 还可能显示每个用例的进度行,但最终应有 3 个测试通过。
为什么要显式断言结束事件
如果只写 emitsInOrder([1, 2, 3]),这组匹配器只关心前三个匹配事件,不够明确地表达“之后不应再有事件”。把 emitsDone 放在最后,相当于把流关闭也写进协议:多发一个值、永不结束或在结束前抛错,都会让测试失败。
错误同样是事件序列的一部分。emitsError(isA<StateError>()) 既验证错误发生在正确位置,也避免把测试绑死到完整错误文本;只有业务确实依赖消息内容时,才需要进一步匹配错误对象的字段或字符串。
避免让流测试变得不稳定
不要对同一个单订阅 Stream 连续执行两次独立的 expectLater,第一次断言已经建立订阅,第二次可能直接触发“已监听”错误。若要验证多个条件,应把它们合并进同一个 emitsInOrder,或为每个测试重新创建一条流。
对于广播流,还要注意“先发事件、后订阅”会丢失早期事件。测试中最好在创建断言后再触发生产逻辑,或让被测对象在订阅建立后才开始发送。这样断言验证的是事件协议本身,而不是调度时机造成的偶然结果。