fuchsia.test

添加次数：7

协议

CaseIterator

在 fuchsia.test/suite.fidl 中定义

用于列出可用测试用例的迭代器。

GetNext

返回下一批测试用例。

请求

<EMPTY>

响应

名称类型
cases vector<Case>

CaseListener

在 fuchsia.test/suite.fidl 中定义

监听来自单个测试用例运行的更新。

已读完

表示单个测试用例已完成且有结果。

请求

名称类型
result Result

RunListener

在 fuchsia.test/suite.fidl 中定义

监听测试运行的更新。

OnFinished

表示启动的最后一个测试用例已完成，不会再启动。

请求

<EMPTY>

OnTestCaseStarted

表示单个测试调用已开始执行。

请求

名称类型
invocation Invocation
std_handles StdHandles
listener server_end<CaseListener>

套件

在 fuchsia.test/suite.fidl 中定义

GetTests

枚举此测试套件中可用的测试用例。

请求

名称类型
iterator server_end<CaseIterator>

运行

运行指定的测试用例。结果将通过结果渠道返回。

tests 可能包含重复的元素，在这种情况下，系统会按照指示多次运行同一测试。结束 listener 表示此调用结束。

请求

名称类型
tests vector<Invocation>
options RunOptions
listener RunListener

枚举

状态：严格

类型：uint32

在 fuchsia.test/suite.fidl 中定义

表示测试调用之后的成功、失败或其他可能的情况。

名称值说明
1

测试已通过。
2

测试失败。
3

已跳过测试。 “已跳过”状态通常表示未尝试运行测试。

示例： 该测试被开发者停用。 不满足运行测试的前提条件。

表

充电盒

在 fuchsia.test/suite.fidl 中定义

描述单个测试用例。

序数字段类型说明
name Name

唯一标识测试套件中的测试用例。 此成员为必填字段。
enabled bool

开发者是启用还是停用（标记为已忽略/已跳过）测试。 如果省略了该成员，系统会假定该测试已启用。

调用

在 fuchsia.test/suite.fidl 中定义

要运行的测试的规范。

序数字段类型说明
name Name

唯一标识测试套件中的测试用例。 此成员为必填字段。
tag Tag

可选标记，由 Suite 的客户端任意指定。套件协议不会使用此字段，但 OnTestCaseStarted 会按原样回传此字段。

结果

在 fuchsia.test/suite.fidl 中定义

调用单个测试用例的结果。

序数字段类型说明
status Status

此成员为必填字段。

RunOptions

在 fuchsia.test/suite.fidl 中定义

（可选）有关运行测试用例的其他说明。

序数字段类型说明
include_disabled_tests bool

如果设置为 true，系统会执行已被测试作者停用的测试用例。
parallel uint16

定义同时运行的最大测试用例数。 如果未指定，则由 Suite 实现选择默认行为。
arguments vector<string>

要传递给测试的可选参数。
break_on_failure bool

向测试运行程序指示，如果遇到失败情况（如果可能），应暂停该套件，并允许连接调试程序。如果运行程序不支持选择性地停止正在运行的套件，则可以忽略此标志。

添加了：HEAD

StdHandles 资源

在 fuchsia.test/suite.fidl 中定义

测试用例中的标准输出/错误句柄。

序数字段类型说明
out handle<socket>

stdout 句柄上。
err handle<socket>

stderr 句柄。

常量

名称值类型说明
MAX_TEST_NAME 2048 uint64

测试用例或标记中使用的名称的最大长度（以字节为单位）。

添加数量：14

别名

名称值说明
名称 string[MAX_TEST_NAME]

测试用例的直观易懂的名称。

添加数量：14
标记 string[MAX_TEST_NAME]

（可选）用于标识调用的唯一标记。

添加数量：14