跨平台开发 / 系统课时
用 dart test 跑通首个用例
用 dart test 跑通首个用例
测试环境是否真正可用,最直接的判断不是依赖已经安装,而是测试文件能够被发现、执行,并用退出状态告诉外部工具成功还是失败。本篇创建一个最小用例,分别观察通过与失败时的结果。
学习目标
- 使用
test()、expect()编写最小 Dart 测试 - 用
dart test执行指定测试文件并读取结果 - 区分测试通过、断言失败和进程退出状态
准备最小测试文件
开始前,当前目录应是一个 Dart 项目,并且 test 已配置为开发依赖。如果尚未添加,可以在项目根目录执行:
dart pub add dev:test预期输出如下,具体版本和变更数量由当前依赖环境决定:
Resolving dependencies...
...
Changed <N> dependencies!在项目中创建 test/add_test.dart。下面的示例把待验证函数也放在测试文件内,因此可以直接运行,不依赖其他业务文件:
import 'package:test/test.dart';
int add(int a, int b) => a + b;
void main() {
test('adds two integers', () {
// expect 将实际值与 matcher 描述的期望条件进行比较。
expect(add(2, 3), equals(5));
});
}test() 定义一个独立用例,第一个参数是测试名称,回调函数包含测试行为。expect() 的第一个参数是实际值,第二个参数是匹配器;当匹配失败时,该用例会被标记为失败,而不是继续被当作成功结果。
执行测试并确认成功
在 Bash 或 zsh 中执行下面的命令。这里显式指定测试文件,并使用展开式报告器方便观察用例名称,同时打印测试进程的退出状态:
dart test test/add_test.dart --reporter expanded
status=$?
echo exit=$status预期输出的时间字段会随机器不同,因此使用 <TIME> 表示动态值:
<TIME> +0: loading test/add_test.dart
<TIME> +0: adds two integers
<TIME> +1: All tests passed!
exit=0+1 表示已经通过一个测试。更重要的是最后的退出状态 0:Shell、CI 服务或构建脚本可以依靠它判断这一轮测试是否成功,而不需要解析自然语言日志。
直接执行 dart test 而不指定文件时,测试运行器会寻找项目测试目录中的测试;开发阶段定位单个问题时可以指定文件,完整验证时则通常执行整个测试集。
制造一次断言失败
为了确认失败链路也正常工作,可以临时把同一个文件中的期望值改错。下面是片段示例,依赖前面的 test() 上下文,只替换原来的 expect() 调用:
expect(add(2, 3), equals(6));再次运行相同命令:
dart test test/add_test.dart --reporter expanded
status=$?
echo exit=$status预期输出会包含失败用例、期望值与实际值,并以非零状态结束;堆栈中的文件位置会因环境不同而变化,因此这里省略动态部分:
<TIME> +0 -1: adds two integers [E]
Expected: <6>
Actual: <5>
...
<TIME> +0 -1: Some tests failed.
exit=1这里的 -1 表示出现一个失败测试。断言失败与代码无法编译虽然都可能让测试命令失败,但处理方式不同:前者应检查业务结果或期望值,后者则需要先解决语法、类型或导入问题。
把退出状态当作质量信号
本地开发时,人通常先看失败信息;自动化环境更关心进程退出状态。测试全部通过时返回成功状态,出现失败时返回非零状态,因此流水线可以据此停止后续发布步骤。
修改完实验中的错误期望后,应把断言恢复为 equals(5) 并再次执行测试,直到看到全部测试通过且退出状态恢复为 0。这样才算真正验证了测试文件发现、断言执行、失败报告和退出状态这条最小测试链路。