TestLoggingContainer

目錄

屬性
方法
腳本區塊
屬性詳細資訊
API 文件TestLoggingContainer

所有與測試日誌相關選項的容器。可以為每個日誌級別設定不同的選項。直接設定的選項（未指定日誌級別）將套用於 LIFECYCLE 日誌級別。範例

apply plugin: 'java'

test {
    testLogging {
        // set options for log level LIFECYCLE
        events("failed")
        exceptionFormat = "short"

        // set options for log level DEBUG
        debug {
            events("started", "skipped", "failed")
            exceptionFormat = "full"
        }

        // remove standard output/error logging from --info builds
        // by assigning only 'failed' and 'skipped' events
        info.events = ["failed", "skipped"]
    }
}

現有的預設值分別在 WARN、LIFECYCLE、INFO 和 DEBUG 日誌級別上顯示逐漸增加的資訊。

屬性

屬性描述
debug

傳回 debug 級別的日誌選項。

顯示粒度

要記錄的事件的顯示粒度。例如，如果設定為 0，方法級別的事件將顯示為「Test Run > Test Worker x > org.SomeClass > org.someMethod」。如果設定為 2，相同的事件將顯示為「org.someClass > org.someMethod」。

error

傳回 error 級別的日誌選項。

事件

要記錄的事件。

例外格式

用於記錄測試例外的格式。僅在 showStackTraces 為 true 時相關。預設值為 INFO 和 DEBUG 日誌級別的 TestExceptionFormat.FULL 以及 LIFECYCLE 日誌級別的 TestExceptionFormat.SHORT。

info

取得 info 級別的日誌選項。

lifecycle

傳回 lifecycle 級別的日誌選項。

最大粒度

要記錄的事件的最大粒度。通常，0 對應於整個測試運行的 Gradle 產生的測試套件，1 對應於特定測試 JVM 的 Gradle 產生的測試套件，2 對應於測試類別，而 3 對應於測試方法。如果執行使用者定義的套件或參數化測試方法，這些值可能會擴展得更高。來自高於指定粒度的級別的事件將被忽略。

最小粒度

要記錄的事件的最小粒度。通常，0 對應於來自整個測試運行的 Gradle 產生的測試套件的事件，1 對應於來自特定測試 JVM 的 Gradle 產生的測試套件的事件，2 對應於測試類別，而 3 對應於測試方法。如果執行使用者定義的套件或參數化測試方法，這些值可能會擴展得更高。來自低於指定粒度的級別的事件將被忽略。

quiet

傳回 quiet 級別的日誌選項。

顯示原因

指示是否記錄測試執行期間發生的例外的成因。僅在 showExceptions 為 true 時相關。預設為 true。

顯示例外

指示是否記錄測試執行期間發生的例外。通常，這些例外與「失敗」事件同時發生。預設為 true。

顯示堆疊追蹤

指示是否記錄測試執行期間發生的例外的堆疊追蹤。預設為 true。

顯示標準串流

指示是否記錄標準輸出和標準錯誤的輸出。相當於檢查是否設定了 TestLogEvent.STANDARD_OUT 和 TestLogEvent.STANDARD_ERROR 這兩個日誌事件。

堆疊追蹤過濾器

用於清理測試堆疊追蹤的過濾器集合。

warn

取得 warn 級別的日誌選項。

方法

沒有方法

腳本區塊

沒有腳本區塊

屬性詳細資訊

傳回 debug 級別的日誌選項。

int displayGranularity

要記錄的事件的顯示粒度。例如，如果設定為 0，方法級別的事件將顯示為「Test Run > Test Worker x > org.SomeClass > org.someMethod」。如果設定為 2，相同的事件將顯示為「org.someClass > org.someMethod」。

-1 表示最高粒度，並對應於原子測試。

傳回 error 級別的日誌選項。

要記錄的事件。

TestExceptionFormat exceptionFormat

用於記錄測試例外的格式。僅在 showStackTraces 為 true 時相關。預設值為 INFO 和 DEBUG 日誌級別的 TestExceptionFormat.FULL 以及 LIFECYCLE 日誌級別的 TestExceptionFormat.SHORT。

取得 info 級別的日誌選項。

TestLogging lifecycle

傳回 lifecycle 級別的日誌選項。

int maxGranularity

要記錄的事件的最大粒度。通常，0 對應於整個測試運行的 Gradle 產生的測試套件，1 對應於特定測試 JVM 的 Gradle 產生的測試套件，2 對應於測試類別，而 3 對應於測試方法。如果執行使用者定義的套件或參數化測試方法，這些值可能會擴展得更高。來自高於指定粒度的級別的事件將被忽略。

預設粒度為 -1，表示應僅記錄最細粒度級別的測試事件。將此值設定為較低的值將導致忽略較高級別的事件。例如，將值設定為 3 將僅記錄來自測試方法級別的事件，而來自參數化測試方法迭代的任何事件都將被忽略。

int minGranularity

要記錄的事件的最小粒度。通常，0 對應於來自整個測試運行的 Gradle 產生的測試套件的事件，1 對應於來自特定測試 JVM 的 Gradle 產生的測試套件的事件，2 對應於測試類別，而 3 對應於測試方法。如果執行使用者定義的套件或參數化測試方法，這些值可能會擴展得更高。來自低於指定粒度的級別的事件將被忽略。

預設粒度為 -1，表示應僅記錄最細粒度級別的測試事件。換句話說，如果測試方法未參數化，則僅記錄來自測試方法的事件，而忽略來自測試類別和更低級別的事件。另一方面，如果測試方法已參數化，則記錄來自該測試方法迭代的事件，而忽略來自測試方法和更低級別的事件。

傳回 quiet 級別的日誌選項。

boolean showCauses

指示是否記錄測試執行期間發生的例外的成因。僅在 showExceptions 為 true 時相關。預設為 true。

boolean showExceptions

指示是否記錄測試執行期間發生的例外。通常，這些例外與「失敗」事件同時發生。預設為 true。

boolean showStackTraces

指示是否記錄測試執行期間發生的例外的堆疊追蹤。預設為 true。

boolean showStandardStreams

指示是否記錄標準輸出和標準錯誤的輸出。相當於檢查是否設定了 TestLogEvent.STANDARD_OUT 和 TestLogEvent.STANDARD_ERROR 這兩個日誌事件。

Set<TestStackTraceFilter> stackTraceFilters

用於清理測試堆疊追蹤的過濾器集合。

取得 warn 級別的日誌選項。