TestLogging

API 文档TestLogging
已知子类型
TestLoggingContainer

决定哪些测试事件被记录以及记录详细程度的选项。

属性

属性描述
displayGranularity

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

events

要记录的事件。

exceptionFormat

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

maxGranularity

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

minGranularity

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

showCauses

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

showExceptions

说明是否记录测试执行期间发生的异常。通常,这些异常与“失败”事件同时发生。默认为 true。

showStackTraces

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

showStandardStreams

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

stackTraceFilters

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

方法

无方法

脚本块

无脚本块

属性详情

int displayGranularity

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

-1 表示最高粒度,对应于原子测试。

要记录的事件。

TestExceptionFormat exceptionFormat

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

int maxGranularity

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

默认粒度为 -1,它指定只应记录来自最细粒度级别的测试事件。将此值设置为较低的值将导致忽略来自较高级别的事件。例如,将该值设置为 3 将仅记录来自测试方法级别的事件,并且将忽略来自参数化测试方法的迭代的任何事件。

int minGranularity

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

默认粒度为 -1,它指定只应记录来自最细粒度级别的测试事件。换句话说,如果一个测试方法没有参数化,则只会记录来自该测试方法的事件,而来自测试类和更低级别的事件将被忽略。另一方面,如果一个测试方法被参数化,那么将记录来自该测试方法的迭代的事件,而来自该测试方法和更低级别的事件将被忽略。

boolean showCauses

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

boolean showExceptions

说明是否记录测试执行期间发生的异常。通常,这些异常与“失败”事件同时发生。默认为 true。

boolean showStackTraces

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

boolean showStandardStreams

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

Set<TestStackTraceFilter> stackTraceFilters

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