Configuration

To configure this plugin, create a file named jesthtmlreporter.config.json in the root folder of the project. Please note that all configuration properties are optional.

Available Configuration Properties

Property	Type	Description	Default
`pageTitle`	`STRING`	The title of the document. This string will also be outputted on the top of the page.	`"Test Suite"`
`outputPath`	`STRING`	The path to where the plugin will output the HTML report. The path must include the filename and end with .html	`"./test-report.html"`
`includeFailureMsg`	`BOOLEAN`	If this setting is set to true, this will output the detailed failure message for each failed test.	`false`
`styleOverridePath`	`STRING`	The path to a file containing CSS styles that should override the default styling.*	`null`
`theme`	`STRING`	The name of the reporter themes to use when rendering the report. Available themes are located within style/	`"defaultTheme"`
`executionTimeWarningThreshold`	`NUMBER`	The threshold for test execution time (in seconds) in each test suite that will render a warning on the report page. 5 seconds is the default timeout in Jest.	`5`
`dateFormat`	`STRING`	The format in which date/time should be formatted in the test report. Have a look at this page for the available date format variables.	`"yyyy-mm-dd HH:MM:ss"`

*A note on styleOverridePath

The plugin will search for the file from the root directory, therefore there is no need to prepend the string with ./ or ../

Have a look at the default styling (located within style/defaultTheme.css) for a reference of the elements available for styling.

Example Configuration

{
	"pageTitle": "Your test suite",
	"outputPath": "test-report/index.html",
	"includeFailureMsg": false,
	"styleOverridePath": "src/teststyle.css",
	"executionTimeWarningThreshold": 5
}

Alternative configuration with package.json

Add an entry named "jest-html-reporter" to your package.json

{
	...
	"jest-html-reporter": {
		"pageTitle": "Your test suite",
		"outputPath": "test-report.html",
		"includeFailureMsg": true
	}
}

Continuous Integration

Configuration may also be performed with environment variables for dynamic file saving paths in different environments.

NOTE: jesthtmlreporter.config.json and package.json will take precedence over environment variables.

Example

Here is an example of dynamically naming your output file and test report title to match your current branch that one might see in a automated deployment pipeline before running their tests.

export BRANCH_NAME=`git symbolic-ref HEAD 2>/dev/null | cut -d"/" -f 3`
export JEST_HTML_REPORTER_OUTPUT_PATH=/home/username/jest-test-output/test-reports/"$BRANCH_NAME".html
export JEST_HTML_REPORTER_PAGE_TITLE="$BRANCH_NAME"\ Test\ Report

Configuration Environment Variables

The environment variables reflect the properties set in the JSON configuration file. Please see the configuration properties at the top of this page for more information.