Module org.junit.platform.launcher
Package org.junit.platform.launcher

Class LauncherConstants

java.lang.Object
org.junit.platform.launcher.LauncherConstants
@API(status=STABLE,
     since="1.7")
public class LauncherConstants
extends Object
Collection of constants related to Launcher.
Since:
1.3
See Also:
ConfigurationParameters

  • Field Details

    • CAPTURE_STDOUT_PROPERTY_NAME

      public static final String CAPTURE_STDOUT_PROPERTY_NAME
      Property name used to enable capturing output to System.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:
      STDOUT_REPORT_ENTRY_KEY, ReportEntry, TestExecutionListener.reportingEntryPublished(TestIdentifier, ReportEntry), Constant Field Values

    • CAPTURE_STDERR_PROPERTY_NAME

      public static final String CAPTURE_STDERR_PROPERTY_NAME
      Property name used to enable capturing output to System.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:
      STDERR_REPORT_ENTRY_KEY, ReportEntry, TestExecutionListener.reportingEntryPublished(TestIdentifier, ReportEntry), Constant Field Values

    • CAPTURE_MAX_BUFFER_PROPERTY_NAME

      public static final String 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, Constant Field Values

    • CAPTURE_MAX_BUFFER_DEFAULT

      public static final int CAPTURE_MAX_BUFFER_DEFAULT
      Default maximum number of bytes for buffering to use per thread and output type if output capturing is enabled.
      See Also:
      CAPTURE_MAX_BUFFER_PROPERTY_NAME, Constant Field Values

    • STDOUT_REPORT_ENTRY_KEY

      public static final String STDOUT_REPORT_ENTRY_KEY
      Key used to publish captured output to System.out as part of a ReportEntry: "stdout"
      See Also:
      Constant Field Values

    • STDERR_REPORT_ENTRY_KEY

      public static final String STDERR_REPORT_ENTRY_KEY
      Key used to publish captured output to System.err as part of a ReportEntry: "stderr"
      See Also:
      Constant Field Values

    • DEACTIVATE_LISTENERS_PATTERN_PROPERTY_NAME

      public static final String DEACTIVATE_LISTENERS_PATTERN_PROPERTY_NAME
      Property name used to provide patterns for deactivating listeners registered via the ServiceLoader 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 the org.junit base package and any of its subpackages.
      • *.MyListener: deactivates every listener whose simple class name is exactly MyListener.
      • *System*, *Dev*: deactivates every listener whose FQCN contains System or Dev.
      • org.example.MyListener, org.example.TheirListener: deactivates listeners whose FQCN is exactly org.example.MyListener or org.example.TheirListener.
      See Also:
      DEACTIVATE_ALL_LISTENERS_PATTERN, TestExecutionListener, Constant Field Values

    • DEACTIVATE_ALL_LISTENERS_PATTERN

      public static final String DEACTIVATE_ALL_LISTENERS_PATTERN
      Wildcard pattern which signals that all listeners registered via the ServiceLoader mechanism should be deactivated: "*"
      See Also:
      DEACTIVATE_LISTENERS_PATTERN_PROPERTY_NAME, TestExecutionListener, Constant Field Values