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 级别的日志选项。

displayGranularity

要记录的事件的显示粒度。例如，如果设置为 0，方法级别的事件将显示为 “Test Run > Test Worker x > org.SomeClass > org.someMethod”。如果设置为 2，则相同的事件将显示为 “org.someClass > org.someMethod”。

error

返回 error 级别的日志选项。

events

要记录的事件。

exceptionFormat

用于记录测试异常的格式。仅当 showStackTraces 为 true 时相关。INFO 和 DEBUG 日志级别默认为 TestExceptionFormat.FULL，LIFECYCLE 日志级别默认为 TestExceptionFormat.SHORT。

info

获取 info 级别的日志选项。

lifecycle

返回 lifecycle 级别的日志选项。

maxGranularity

要记录的事件的最大粒度。通常，0 对应于为整个测试运行生成的 Gradle 测试套件，1 对应于特定测试 JVM 的 Gradle 生成的测试套件，2 对应于测试类，3 对应于测试方法。如果执行用户定义的套件或参数化测试方法，这些值可能会更高。将忽略来自高于指定粒度的级别的事件。

minGranularity

要记录的事件的最小粒度。通常，0 对应于来自为整个测试运行生成的 Gradle 测试套件的事件，1 对应于来自特定测试 JVM 的 Gradle 生成的测试套件的事件，2 对应于测试类，3 对应于测试方法。如果执行用户定义的套件或参数化测试方法，这些值可能会更高。将忽略来自低于指定粒度的级别的事件。

quiet

返回 quiet 级别的日志选项。

showCauses

指示是否记录测试执行期间发生的异常的原因。仅当 showExceptions 为 true 时相关。默认为 true。

showExceptions

指示是否记录测试执行期间发生的异常。通常，这些异常与 “failed” 事件一致。默认为 true。

showStackTraces

指示是否记录测试执行期间发生的异常的堆栈跟踪。默认为 true。

showStandardStreams

指示是否记录标准输出和标准错误上的输出。等同于检查是否设置了日志事件 TestLogEvent.STANDARD_OUT 和 TestLogEvent.STANDARD_ERROR。

stackTraceFilters

用于清理测试堆栈跟踪的过滤器集合。

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

指示是否记录测试执行期间发生的异常。通常，这些异常与 “failed” 事件一致。默认为 true。

boolean showStackTraces

指示是否记录测试执行期间发生的异常的堆栈跟踪。默认为 true。

boolean showStandardStreams

指示是否记录标准输出和标准错误上的输出。等同于检查是否设置了日志事件 TestLogEvent.STANDARD_OUT 和 TestLogEvent.STANDARD_ERROR。

Set<TestStackTraceFilter> stackTraceFilters

用于清理测试堆栈跟踪的过滤器集合。

获取 warn 级别的日志选项。