Launcher
.- Since:
- 1.3
- See Also:
-
Field Summary
Modifier and TypeFieldDescriptionstatic final int
Default maximum number of bytes for buffering to use per thread and output type if output capturing is enabled.static final String
Property name used to configure the maximum number of bytes for buffering to use per thread and output type if output capturing is enabled: "junit.platform.output.capture.maxBuffer"static final String
Property name used to enable capturing output toSystem.err
: "junit.platform.output.capture.stderr"static final String
Property name used to enable capturing output toSystem.out
: "junit.platform.output.capture.stdout"static final String
Wildcard pattern which signals that all listeners registered via theServiceLoader
mechanism should be deactivated: "*"static final String
Property name used to provide patterns for deactivating listeners registered via theServiceLoader
mechanism: "junit.platform.execution.listeners.deactivate"static final String
Property name used to enable dry-run mode for test execution.static final String
Property name used to enable support forLauncherInterceptor
instances to be registered via theServiceLoader
mechanism: "junit.platform.launcher.interceptors.enabled"static final String
Property name used to enable or disable stack trace pruning.static final String
Key used to publish captured output toSystem.err
as part of aReportEntry
: "stderr"static final String
Key used to publish captured output toSystem.out
as part of aReportEntry
: "stdout" -
Method Summary
-
Field Details
-
CAPTURE_STDOUT_PROPERTY_NAME
Property name used to enable capturing output toSystem.out
: "junit.platform.output.capture.stdout"By default, output to
System.out
is not captured.If enabled, the JUnit Platform captures the corresponding output and publishes it as a
ReportEntry
using the "stdout" key immediately before reporting the test identifier as finished.- See Also:
-
CAPTURE_STDERR_PROPERTY_NAME
Property name used to enable capturing output toSystem.err
: "junit.platform.output.capture.stderr"By default, output to
System.err
is not captured.If enabled, the JUnit Platform captures the corresponding output and publishes it as a
ReportEntry
using the "stderr" key immediately before reporting the test identifier as finished.- See Also:
-
CAPTURE_MAX_BUFFER_PROPERTY_NAME
Property name used to configure the maximum number of bytes for buffering to use per thread and output type if output capturing is enabled: "junit.platform.output.capture.maxBuffer"Value must be an integer; defaults to 4194304.
- See Also:
-
CAPTURE_MAX_BUFFER_DEFAULT
public static final int CAPTURE_MAX_BUFFER_DEFAULTDefault maximum number of bytes for buffering to use per thread and output type if output capturing is enabled.- See Also:
-
STDOUT_REPORT_ENTRY_KEY
Key used to publish captured output toSystem.out
as part of aReportEntry
: "stdout"- See Also:
-
STDERR_REPORT_ENTRY_KEY
Key used to publish captured output toSystem.err
as part of aReportEntry
: "stderr"- See Also:
-
DEACTIVATE_LISTENERS_PATTERN_PROPERTY_NAME
Property name used to provide patterns for deactivating listeners registered via theServiceLoader
mechanism: "junit.platform.execution.listeners.deactivate"Pattern Matching Syntax
If the property value consists solely of an asterisk (
*
), all listeners will be deactivated. Otherwise, the property value will be treated as a comma-separated list of patterns where each individual pattern will be matched against the fully qualified class name (FQCN) of each registered listener. Any dot (.
) in a pattern will match against a dot (.
) or a dollar sign ($
) in a FQCN. Any asterisk (*
) will match against one or more characters in a FQCN. All other characters in a pattern will be matched one-to-one against a FQCN.Examples
*
: deactivates all listeners.org.junit.*
: deactivates every listener under theorg.junit
base package and any of its subpackages.*.MyListener
: deactivates every listener whose simple class name is exactlyMyListener
.*System*, *Dev*
: deactivates every listener whose FQCN containsSystem
orDev
.org.example.MyListener, org.example.TheirListener
: deactivates listeners whose FQCN is exactlyorg.example.MyListener
ororg.example.TheirListener
.
Only listeners registered via the
ServiceLoader
mechanism can be deactivated. In other words, any listener registered explicitly via theLauncherDiscoveryRequest
cannot be deactivated via this configuration parameter.In addition, since execution listeners are registered before the test run starts, this configuration parameter can only be supplied as a JVM system property or via the JUnit Platform configuration file but cannot be supplied in the
LauncherDiscoveryRequest
} that is passed to theLauncher
.- See Also:
-
DEACTIVATE_ALL_LISTENERS_PATTERN
Wildcard pattern which signals that all listeners registered via theServiceLoader
mechanism should be deactivated: "*"- See Also:
-
ENABLE_LAUNCHER_INTERCEPTORS
Property name used to enable support forLauncherInterceptor
instances to be registered via theServiceLoader
mechanism: "junit.platform.launcher.interceptors.enabled"By default, interceptor registration is disabled.
Since interceptors are registered before the test run starts, this configuration parameter can only be supplied as a JVM system property or via the JUnit Platform configuration file but cannot be supplied in the
LauncherDiscoveryRequest
} that is passed to theLauncher
.- See Also:
-
DRY_RUN_PROPERTY_NAME
Property name used to enable dry-run mode for test execution.When dry-run mode is enabled, no tests will be executed. Instead, all registered
TestExecutionListeners
will receive events for all test descriptors that are part of the discoveredTestPlan
. All containers will be reported as successful and all tests as skipped. This can be useful to test changes in the configuration of a build or to verify a listener is called as expected without having to wait for all tests to be executed.Value must be either
true
orfalse
; defaults tofalse
.- See Also:
-
STACKTRACE_PRUNING_ENABLED_PROPERTY_NAME
@API(status=EXPERIMENTAL, since="1.10") public static final String STACKTRACE_PRUNING_ENABLED_PROPERTY_NAMEProperty name used to enable or disable stack trace pruning.By default, stack trace pruning is enabled.
- See Also:
-