| API 文件 | TestLogging |
|---|
| 已知子類型 |
|
|---|
決定要記錄哪些測試事件及其詳細程度的選項。
| 屬性 | 描述 |
displayGranularity | 要記錄的事件的顯示粒度。例如，如果設定為 0，方法層級事件將顯示為「Test Run > Test Worker x > org.SomeClass > org.someMethod」。如果設定為 2，相同的事件將顯示為「org.someClass > org.someMethod」。 |
events | 要記錄的事件。 |
exceptionFormat | 用於記錄測試異常的格式。僅在 |
maxGranularity | 要記錄的事件的最大粒度。通常，0 對應於整個測試執行的 Gradle 產生測試套件，1 對應於特定測試 JVM 的 Gradle 產生測試套件，2 對應於測試類別，而 3 對應於測試方法。如果執行使用者定義的套件或參數化測試方法，這些值可能會更高。將忽略來自高於指定粒度的層級的事件。 |
minGranularity | 要記錄的事件的最小粒度。通常，0 對應於來自整個測試執行的 Gradle 產生測試套件的事件，1 對應於特定測試 JVM 的 Gradle 產生測試套件，2 對應於測試類別，而 3 對應於測試方法。如果執行使用者定義的套件或參數化測試方法，這些值可能會更高。將忽略來自低於指定粒度的層級的事件。 |
showCauses | 指示是否記錄測試執行期間發生的異常原因。僅在 |
showExceptions | 指示是否記錄測試執行期間發生的異常。通常，這些異常與「failed」事件一致。預設為 true。 |
showStackTraces | 指示是否記錄測試執行期間發生的異常堆疊追蹤。預設為 true。 |
showStandardStreams | 指示是否記錄標準輸出和標準錯誤的輸出。相當於檢查是否同時設定了日誌事件 |
stackTraceFilters | 用於清理測試堆疊追蹤的過濾器集合。 |
要記錄的事件的顯示粒度。例如，如果設定為 0，方法層級事件將顯示為「Test Run > Test Worker x > org.SomeClass > org.someMethod」。如果設定為 2，相同的事件將顯示為「org.someClass > org.someMethod」。
-1 表示最高粒度，對應於原子測試。
Set<TestLogEvent>events
Set<TestLogEvent>要記錄的事件。
TestExceptionFormat exceptionFormat
用於記錄測試異常的格式。僅在 showStackTraces 為 true 時相關。預設為 INFO 和 DEBUG 日誌層級的 TestExceptionFormat.FULL 以及 LIFECYCLE 日誌層級的 TestExceptionFormat.SHORT。
要記錄的事件的最大粒度。通常，0 對應於整個測試執行的 Gradle 產生測試套件，1 對應於特定測試 JVM 的 Gradle 產生測試套件，2 對應於測試類別，而 3 對應於測試方法。如果執行使用者定義的套件或參數化測試方法，這些值可能會更高。將忽略來自高於指定粒度的層級的事件。
預設粒度為 -1，表示僅應記錄最細粒度層級的測試事件。將此值設定為較低的值將導致忽略來自較高層級的事件。例如，將值設定為 3 將僅記錄來自測試方法層級的事件，並且將忽略來自參數化測試方法的任何迭代事件。
要記錄的事件的最小粒度。通常，0 對應於來自整個測試執行的 Gradle 產生測試套件的事件，1 對應於特定測試 JVM 的 Gradle 產生測試套件，2 對應於測試類別，而 3 對應於測試方法。如果執行使用者定義的套件或參數化測試方法，這些值可能會更高。將忽略來自低於指定粒度的層級的事件。
預設粒度為 -1，表示僅應記錄最細粒度層級的測試事件。換句話說，如果測試方法未參數化，則僅會記錄來自測試方法的事件，而忽略來自測試類別和更低層級的事件。另一方面，如果測試方法已參數化，則將記錄來自該測試方法迭代的事件，而忽略來自測試方法和更低層級的事件。
指示是否記錄標準輸出和標準錯誤的輸出。相當於檢查是否同時設定了日誌事件 TestLogEvent.STANDARD_OUT 和 TestLogEvent.STANDARD_ERROR。
Set<TestStackTraceFilter>stackTraceFilters
Set<TestStackTraceFilter>用於清理測試堆疊追蹤的過濾器集合。