Fork me on GitHub

surefire-report:report

Note:This goal should be used as a Maven report.

Full name:

org.apache.maven.plugins:maven-surefire-report-plugin:2.16:report

Description:

Creates a nicely formatted Surefire Test Report in html format.

Attributes:

  • Requires a Maven project to be executed.
  • Invokes the execution of the lifecycle phase test prior to executing itself.
  • Executes in its own lifecycle: surefire.
  • Is NOT inherited by default in multi-project builds.

Required Parameters

Name Type Since Description
outputName String - The filename to use for the report.
Default value is: surefire-report.
User property is: outputName.
showSuccess boolean - If set to false, only failures are shown.
Default value is: true.
User property is: showSuccess.

Optional Parameters

Name Type Since Description
aggregate boolean - Whether to build an aggregated report at the root, or build individual reports.
Default value is: false.
User property is: aggregate.
alwaysGenerateSurefireReport boolean 2.11 If set to true the surefire report will be generated even when there are no surefire result files. Defaulyts to true to preserve legacy behaviour pre 2.10.
Default value is: true.
User property is: alwaysGenerateSurefireReport.
linkXRef boolean - Whether to link the XRef if found.
Default value is: true.
User property is: linkXRef.
outputDirectory File - Location where generated html will be created.
User property is: project.reporting.outputDirectory.
reportsDirectories File[] - Directories containing the XML Report files that will be parsed and rendered to HTML format.
reportsDirectory File - (Deprecated, use reportsDirectories) This directory contains the XML Report files that will be parsed and rendered to HTML format.
skipSurefireReport boolean 2.11 If set to true the surefire report generation will be skipped.
Default value is: false.
User property is: skipSurefireReport.
xrefLocation File - Location of the Xrefs to link.
Default value is: ${project.reporting.outputDirectory}/xref-test.

Parameter Details

aggregate:

Whether to build an aggregated report at the root, or build individual reports.
  • Type: boolean
  • Required: No
  • User Property: aggregate
  • Default: false

alwaysGenerateSurefireReport:

If set to true the surefire report will be generated even when there are no surefire result files. Defaulyts to true to preserve legacy behaviour pre 2.10.
  • Type: boolean
  • Since: 2.11
  • Required: No
  • User Property: alwaysGenerateSurefireReport
  • Default: true

linkXRef:

Whether to link the XRef if found.
  • Type: boolean
  • Required: No
  • User Property: linkXRef
  • Default: true

outputDirectory:

Location where generated html will be created.
  • Type: java.io.File
  • Required: No
  • User Property: project.reporting.outputDirectory

outputName:

The filename to use for the report.
  • Type: java.lang.String
  • Required: Yes
  • User Property: outputName
  • Default: surefire-report

reportsDirectories:

Directories containing the XML Report files that will be parsed and rendered to HTML format.
  • Type: java.io.File[]
  • Required: No

reportsDirectory:

(Deprecated, use reportsDirectories) This directory contains the XML Report files that will be parsed and rendered to HTML format.
  • Type: java.io.File
  • Required: No

showSuccess:

If set to false, only failures are shown.
  • Type: boolean
  • Required: Yes
  • User Property: showSuccess
  • Default: true

skipSurefireReport:

If set to true the surefire report generation will be skipped.
  • Type: boolean
  • Since: 2.11
  • Required: No
  • User Property: skipSurefireReport
  • Default: false

xrefLocation:

Location of the Xrefs to link.
  • Type: java.io.File
  • Required: No
  • Default: ${project.reporting.outputDirectory}/xref-test