# jest-html-reporter
> Jest test results processor for generating a summary in HTML
Latest version **4.4.2** (published 2026-09-06) · MIT license · 0 weekly downloads
## Install
```sh
npm install jest-html-reporter
pnpm add jest-html-reporter
yarn add jest-html-reporter
bun add jest-html-reporter
```
## Health
**Score 55/100 (C)** — status: active.
Positive: no vulnerabilities; recently updated; high maintenance score.
Warnings: low downloads; no types; no esm support.
## Facts
| | |
|---|---|
| Version | 4.4.2 |
| Published | 2026-09-06 |
| First published | 2017-03-17 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=14.0.0 |
| Dependencies | 7 |
| Unpacked size | 41.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 287 |
| Author | Johan Hargne |
| Maintainers | hargne |
| Keywords | jest, html, reporter, report, plugin |
## Links
- npm: https://www.npmjs.com/package/jest-html-reporter
- Repository: https://github.com/Hargne/jest-html-reporter
- Homepage: https://github.com/Hargne/jest-html-reporter#readme
- Issues: https://github.com/Hargne/jest-html-reporter/issues
- npm.io page: https://npm.io/package/jest-html-reporter
## Dependencies (7)
- [mkdirp](https://npm.io/package/mkdirp.md) ^1.0.3
- [dateformat](https://npm.io/package/dateformat.md) 3.0.2
- [strip-ansi](https://npm.io/package/strip-ansi.md) 6.0.1
- [xmlbuilder](https://npm.io/package/xmlbuilder.md) 15.0.0
- [@jest/types](https://npm.io/package/@jest/types.md) ^30.0.1
- [@jest/reporters](https://npm.io/package/@jest/reporters.md) ^30.0.2
- [@jest/test-result](https://npm.io/package/@jest/test-result.md) ^30.0.2
## Alternatives
- [@tsparticles/shape-image](https://npm.io/package/@tsparticles/shape-image.md) — 303.7K weekly downloads
- [@tsparticles/shape-line](https://npm.io/package/@tsparticles/shape-line.md) — 233.7K weekly downloads
- [stringify-attributes](https://npm.io/package/stringify-attributes.md) — 58.6K weekly downloads
- [mobile-drag-drop](https://npm.io/package/mobile-drag-drop.md) — 46.3K weekly downloads
- [@comunica/actor-rdf-parse-html](https://npm.io/package/@comunica/actor-rdf-parse-html.md) — 29.2K weekly downloads
## Recent versions
- 4.4.2 (latest) — 2026-09-06
- 3.4.0-beta.1 (beta) — 2021-05-12
- 4.4.1 — 2026-09-06
- 4.4.0 — 2026-03-28
- 4.3.0 — 2025-06-25
- 4.2.0 — 2025-06-21
- 4.1.0 — 2025-03-12
- 4.0.1 — 2025-02-11
- 4.0.0 — 2025-02-10
- 3.10.2 — 2023-08-21
- 3.10.1 — 2023-06-22
- 3.10.0 — 2023-05-25
- 3.9.0 — 2023-05-03
- 3.8.0 — 2023-04-20
- 3.7.1 — 2023-03-18
- … 62 more at https://npm.io/package/jest-html-reporter/versions
## README
📜
jest-html-reporter
A Jest test results processor for generating a summary in HTML.
Inspired by karma-htmlfile-reporter
## Installation
**npm:**
```
$ npm install jest-html-reporter --save-dev
```
**yarn:**
```
$ yarn add jest-html-reporter --dev
```
## Usage
Configure Jest to process the test results by adding the following entry to the Jest config (jest.config.json):
```JSON
"reporters": [
"default",
["./node_modules/jest-html-reporter", {
"pageTitle": "Test Report"
}]
]
```
As you run Jest from within the terminal, a file called _test-report.html_ will be created within your root folder containing information about your tests.
There are multiple configuration options available. Read more about these further down in this document.
#### Alternative Usage as a Test Results Processor
To run the reporter as a test results processor (after Jest is complete instead of running in parallel), add the following entry to the Jest config (jest.config.json):
```JSON
{
"testResultsProcessor": "./node_modules/jest-html-reporter"
}
```
**Note:** When running as a testResultsProcessor, the configuration needs either to be placed within a new file named `jesthtmlreporter.config.json` residing in the root folder
```JSON
{
"pageTitle": "Test Report",
}
```
or via adding a key to `package.json` named "jest-html-reporter":
```JSON
{
...
"jest-html-reporter": {
"pageTitle": "Test Report",
}
}
```
## 📌 Configuration Options (All Optional)
| Option | Type | Default | Description |
| ----------------------------------- | ------------------------------------------ | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **`additionalInformation`** | `Array<{ label: string; value: string; }>` | `null` | A list of additional information to be added to the top of the report. |
| **`append`** | `boolean` | `false` | Append test results to an existing report. |
| **`boilerplate`** | `string` | `null` | Path to an HTML boilerplate file. The `{jesthtmlreporter-content}` variable will be replaced with test results. |
| **`collapseSuitesByDefault`** | `boolean` | `false` | Collapse test suites (accordions) by default. |
| **`customScriptPath`** | `string` | `null` | Path to an external script file injected into the report. |
| **`dateFormat`** | `string` | `yyyy-mm-dd HH:MM:ss` | Date format for timestamps. See [documentation](https://github.com/Hargne/jest-html-reporter/wiki/Date-Format) for available formats. |
| **`executionTimeWarningThreshold`** | `number` | `5` | Warn if a test suite exceeds this execution time (in seconds). |
| **`hideConsoleLogOrigin`** | `boolean` | `false` | Hide `console.log` origin (stack trace) in the report (**requires** `--verbose=false`). |
| **`includeConsoleLog`** | `boolean` | `false` | Include `console.log` outputs in the report (**requires** `--verbose=false`). |
| **`includeFailureMsg`** | `boolean` | `false` | Show detailed error messages for failed tests. |
| **`includeStackTrace`** | `boolean` | `true` | Show stack traces for failed tests. |
| **`includeSuiteFailure`** | `boolean` | `false` | Show detailed errors for entire failed test suites. |
| **`includeObsoleteSnapshots`** | `boolean` | `false` | Show obsolete snapshot names. |
| **`logo`** | `string` | `null` | Path to an image file to display in the report header. |
| **`outputPath`** | `string` | `./test-report.html` | Full path for the output report file (**must end in `.html`**). |
| **`pageTitle`** | `string` | `"Test Report"` | Title of the document and top-level heading. |
| **`sort`** | `string` | `null` | Sort test results by a specific method. Available values:
➤ **`status`** → Sorts by test status (**pending → failed → passed**).
➤ **`status:{custom-order}`** → Custom status order (e.g., `"status:failed,passed,pending"`).
➤ **`executionasc`** → Sorts by execution time **ascending**.
➤ **`executiondesc`** → Sorts by execution time **descending**.
➤ **`titleasc`** → Sorts by suite filename/test name **ascending**.
➤ **`titledesc`** → Sorts by suite filename/test name **descending**. |
| **`statusIgnoreFilter`** | `string` | `null` | **Comma-separated** list of statuses to exclude: `"passed"`, `"pending"`, `"failed"`. |
| **`styleOverridePath`** | `string` | `null` | Path to a CSS file to override default styles. |
| **`useCssFile`** | `boolean` | `false` | Link to the CSS file instead of inlining styles. |
| **`theme`** | `string` | `defaultTheme` | Theme that you are able to set to report (defaultTheme or darkTheme) |
## Continuous Integration
All the configuration options provided in the table above are available via environment variables and follows the pattern of snake case in uppercase prepended with `JEST_HTML_REPORTER_`
**Example:** `customScriptPath` -> `JEST_HTML_REPORTER_CUSTOM_SCRIPT_PATH`
**\*NOTE:** Environment variables will take precedence over configurations set in jesthtmlreporter.config.json and package.json\*
### CI 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.
```bash
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
```
---
_Source: https://npm.io/package/jest-html-reporter · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
