8.2 用例编辑器
用例编辑器由三部分组成:顶部工具条、左侧测试用例列表、右侧用例详情面板(可隐藏)。

8.2.1 顶部工具条
| 按钮 | 说明 |
|---|---|
| 被测文件 | 显示/选择被测规则文件,见 8.1.2 |
| 生成JSON模板 | 按被测文件的入参 / 出参清单生成 JSON 测试用例模板,见 8.5(仅 VSCode 端可用) |
| 导入测试用例 | 选择 JSON 模板文件,由服务端解析后回填用例,见 8.5 |
| 导入测试结果 | 导入结果 JSON,只把结果叠加到用例上,不修改 .tst 文件 |
| 导出测试结果 | 把当前结果导出为 <测试文件名>.testrun.<时间戳>.json |
| 比对:摘要 | 显示当前比对设置摘要;右侧【比对设置】打开配置对话框,见 8.3 |
| 模板设置 | 勾选模板要写入的入参 / 预期属性,配置随测试文件保存(仅 VSCode 端可用) |
| 显示详情 / 隐藏详情 | 切换右侧用例详情面板,该状态按浏览器本地保存 |
工具条下方会出现操作结果横幅(成功 / 警告 / 错误),用于提示导入结果、执行统计、配置保存等信息,可点击右侧【×】关闭。
8.2.2 测试用例列表
列表头部依次显示:用例总条数、最近一次执行情况(执行条数与总耗时,悬停可看被跳过的条数)、【日志】开关、【全部运行】、【新增】、【筛选】。
1)表格字段
| 列 | 说明 |
|---|---|
| 序号 | 行号,从 1 开始 |
| 名称 | 双击可改名;新增时自动生成不重名的 tst0 / tst1…,复制时生成 原名称 副本 |
| 描述 | 双击可改描述 |
| 输入数据 | 显示「已设置 / 未设置」,行内齿轮图标打开输入参数配置 |
| 预期结果 | 显示「已设置 / 未设置」,行内齿轮图标打开预期结果配置 |
| 结果 | 未执行 / 通过 / 失败,悬停提示可查看执行日志 |
| 操作 | 运行当前用例、复制、删除 |
2)筛选
点击【筛选】展开筛选栏,可组合以下条件,生效时按钮上显示小红点:
- 名称、描述:包含关键字匹配;
- 输入数据 / 预期结果:全部 / 已设置 / 未设置;
- 结果:全部 / 成功 / 失败(执行过一次后出现)。
【清除】一次性重置全部筛选条件。
3)统计
执行过用例(或导入过结果)后,列表上方展示统计:总数、通过、失败、未执行、通过率。其中通过 / 失败来自服务端判定结果,未执行指没有结果的用例。
8.2.3 输入参数配置
点击「输入数据」列的齿轮图标打开【输入参数配置】对话框:

只编辑输入数据,不会触发试跑:
- 表单:按被测文件的入参清单逐字段编辑;分组显示字段的声明来源(参数声明于
.ruleproject、变量声明于.var、未归类); - JSON:直接编辑
{入参名: 值},适合整体粘贴或维护嵌套结构,不依赖入参清单; - 【添加变量/参数】:从变量集(
.var)与参数文件(.ruleproject)读取候选,补充清单之外的字段; - 【添加默认入参】:补充带初始值脚本、默认不显示的入参;
- 【复制】/【粘贴】:整份输入数据的复制与粘贴,表单与 JSON 形态通用;
- 两种形态切换时互相同步;确定后写回用例并标记文件已修改。修改输入数据会清空该用例的旧执行结果(旧结果不再可信)。
8.2.4 预期结果配置
点击「预期结果」列的齿轮图标打开【预期结果配置】对话框。
对话框打开时会向服务端请求被测文件的出参清单(/api/batchtest/buildOutputVariables),据此生成表单:
- 表单:按出参清单逐字段填写期望值,分组口径与输入参数配置一致;可从变量集 / 参数文件补充清单之外的字段,也可通过【添加默认入参】补充隐藏入参;
- JSON:键为出参名,值支持对象与数组,提供【格式化】/【复制】/【粘贴】;
- 【复制表单数据】/【粘贴表单数据】:在表单形态下整份复制与粘贴;
- 确定后写回用例并标记文件已修改。
8.2.5 用例详情面板
选中任意一行,右侧展示该用例的详情:

| 区块 | 说明 |
|---|---|
| 状态徽标 | 未执行 / 通过 / 失败,失败与通过同时展示服务端返回的单条耗时(毫秒) |
| 输入数据 | 当前用例的输入数据(格式化 JSON) |
| 实际出参 | 执行后服务端返回的出参,对象结构以可视化面板展示;右上角图标可查看执行日志(仅在执行时开启【日志】才有内容) |
| 预期结果 | 当前用例的预期结果 |
| 字段差异 | 按当前比对设置在本地计算的差异列表(路径 / 预期 / 实际),差异过多时只展示上限条数 |
说明:字段差异由本地按当前比对设置计算,通过与否的结论始终以服务端判定为准。若服务端判定失败而本地未发现差异,通常是比对设置刚调整过(需重新执行)或服务端版本尚未支持本次下发的比对参数。
