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

ENUMS

狀態：嚴格

類型：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

StdHandle 資源

在 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 天