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 日志级别分别显示逐渐增多的信息。
属性 | 描述 |
调试 | 返回调试级别的日志选项。 |
displayGranularity | 要记录的事件的显示粒度。例如,如果设置为 0,方法级别事件将显示为 "Test Run > Test Worker x > org.SomeClass > org.someMethod"。如果设置为 2,同一事件将显示为 "org.someClass > org.someMethod"。 |
error | 返回错误级别的日志选项。 |
events | 要记录的事件。 |
exceptionFormat | 用于记录测试异常的格式。仅当 |
info | 获取信息级别的日志选项。 |
lifecycle | 返回生命周期级别的日志选项。 |
maxGranularity | 要记录的事件的最大粒度。通常,0 对应于整个测试运行的 Gradle 生成的测试套件,1 对应于特定测试 JVM 的 Gradle 生成的测试套件,2 对应于测试类,3 对应于测试方法。如果执行用户定义的套件或参数化测试方法,这些值可能会更高。级别高于指定粒度的事件将被忽略。 |
minGranularity | 要记录的事件的最小粒度。通常,0 对应于整个测试运行的 Gradle 生成的测试套件的事件,1 对应于特定测试 JVM 的 Gradle 生成的测试套件的事件,2 对应于测试类,3 对应于测试方法。如果执行用户定义的套件或参数化测试方法,这些值可能会更高。级别低于指定粒度的事件将被忽略。 |
quiet | 返回静默级别的日志选项。 |
showCauses | 指示是否记录测试执行期间发生的异常原因。仅当 |
showExceptions | 指示是否记录测试执行期间发生的异常。通常这些异常与“失败”事件同时发生。默认为 true。 |
showStackTraces | 指示是否记录测试执行期间发生的异常堆栈跟踪。默认为 true。 |
showStandardStreams | 指示是否记录标准输出和标准错误上的输出。等同于检查日志事件 |
stackTraceFilters | 用于清理测试堆栈跟踪的过滤器集。 |
warn | 获取警告级别的日志选项。 |
TestLogging
debug
返回调试级别的日志选项。
要记录的事件的显示粒度。例如,如果设置为 0,方法级别事件将显示为 "Test Run > Test Worker x > org.SomeClass > org.someMethod"。如果设置为 2,同一事件将显示为 "org.someClass > org.someMethod"。
-1 表示最高粒度,对应于原子测试。
TestLogging
error
返回错误级别的日志选项。
Set
<TestLogEvent
>
events
Set
<TestLogEvent
>要记录的事件。
TestExceptionFormat
exceptionFormat
用于记录测试异常的格式。仅当 showStackTraces
为 true
时相关。对于 INFO 和 DEBUG 日志级别,默认为 TestExceptionFormat.FULL
;对于 LIFECYCLE 日志级别,默认为 TestExceptionFormat.SHORT
。
TestLogging
info
获取信息级别的日志选项。
TestLogging
lifecycle
返回生命周期级别的日志选项。
要记录的事件的最大粒度。通常,0 对应于整个测试运行的 Gradle 生成的测试套件,1 对应于特定测试 JVM 的 Gradle 生成的测试套件,2 对应于测试类,3 对应于测试方法。如果执行用户定义的套件或参数化测试方法,这些值可能会更高。级别高于指定粒度的事件将被忽略。
默认粒度为 -1,这表示只应记录最细粒度级别的测试事件。将此值设置为较低的值将导致忽略更高级别的事件。例如,将值设置为 3 将导致只记录测试方法级别的事件,并忽略参数化测试方法迭代的任何事件。
要记录的事件的最小粒度。通常,0 对应于整个测试运行的 Gradle 生成的测试套件的事件,1 对应于特定测试 JVM 的 Gradle 生成的测试套件的事件,2 对应于测试类,3 对应于测试方法。如果执行用户定义的套件或参数化测试方法,这些值可能会更高。级别低于指定粒度的事件将被忽略。
默认粒度为 -1,这表示只应记录最细粒度级别的测试事件。换句话说,如果测试方法未参数化,则只记录测试方法的事件,并忽略测试类和更低级别的事件。另一方面,如果测试方法已参数化,则将记录该测试方法的迭代事件,并忽略测试方法和更低级别的事件。
TestLogging
quiet
返回静默级别的日志选项。
指示是否记录标准输出和标准错误上的输出。等同于检查日志事件 TestLogEvent.STANDARD_OUT
和 TestLogEvent.STANDARD_ERROR
是否都已设置。
Set
<TestStackTraceFilter
>
stackTraceFilters
Set
<TestStackTraceFilter
>用于清理测试堆栈跟踪的过滤器集。
TestLogging
warn
获取警告级别的日志选项。