# cypress-mochawesome-reporter > Zero config Mochawesome reporter for Cypress with screenshots Latest version **5.0.0** (published 2026-07-31) · MIT license · 0 weekly downloads ## Install ```sh npm install cypress-mochawesome-reporter pnpm add cypress-mochawesome-reporter yarn add cypress-mochawesome-reporter bun add cypress-mochawesome-reporter ``` Provides the command `generate-mochawesome-report`. ## Health **Score 65/100 (B)** — status: active. Positive: has types; no vulnerabilities; has provenance; recently updated; high quality score. Warnings: low downloads; no esm support. ## Facts | | | |---|---| | Version | 5.0.0 | | Published | 2026-07-31 | | First published | 2020-04-16 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | bundled | | Module format | CommonJS | | Node | >=22 | | Dependencies | 4 | | Unpacked size | 37.2 KB | | Known vulnerabilities | 0 | | Install scripts | no | | Provenance | attested (GitHub Actions) | | GitHub stars | 186 | | Author | Liron Er | | Maintainers | lironer | | Keywords | cypress, mochawesome, mocha, reporter, screenshot, video | ## Links - npm: https://www.npmjs.com/package/cypress-mochawesome-reporter - Repository: https://github.com/LironEr/cypress-mochawesome-reporter - Homepage: https://github.com/LironEr/cypress-mochawesome-reporter#readme - Issues: https://github.com/LironEr/cypress-mochawesome-reporter/issues - Funding: https://github.com/sponsors/LironEr - npm.io page: https://npm.io/package/cypress-mochawesome-reporter ## Dependencies (4) - [fs-extra](https://npm.io/package/fs-extra.md) ^11.4.0 - [commander](https://npm.io/package/commander.md) ^15.0.0 - [mochawesome](https://npm.io/package/mochawesome.md) ^8.0.0 - [mochawesome-report-generator](https://npm.io/package/mochawesome-report-generator.md) ^6.3.2 ## Alternatives - [@sindresorhus/slugify](https://npm.io/package/@sindresorhus/slugify.md) — 3.7M weekly downloads - [solid-js](https://npm.io/package/solid-js.md) — 2.7M weekly downloads - [expo-glass-effect](https://npm.io/package/expo-glass-effect.md) — 2.5M weekly downloads - [nanoassert](https://npm.io/package/nanoassert.md) — 780.8K weekly downloads - [@ffmpeg/ffmpeg](https://npm.io/package/@ffmpeg/ffmpeg.md) — 529.5K weekly downloads ## Recent versions - 5.0.0 (latest) — 2026-07-31 - 3.6.0-rc.0 (next) — 2023-08-05 - 2.0.1-beta.0 (beta) — 2021-03-28 - 4.0.2 — 2025-08-21 - 4.0.1 — 2025-08-20 - 4.0.0 — 2025-07-09 - 3.8.4 — 2025-07-09 - 3.8.2 — 2024-02-22 - 3.8.1 — 2024-01-26 - 3.8.0 — 2023-12-29 - 3.7.0 — 2023-11-17 - 3.6.1 — 2023-10-10 - 3.6.0 — 2023-09-09 - 3.5.1 — 2023-06-15 - 3.5.0 — 2023-05-18 - … 27 more at https://npm.io/package/cypress-mochawesome-reporter/versions ## README # cypress-mochawesome-reporter [![npm](https://img.shields.io/npm/v/cypress-mochawesome-reporter)](http://www.npmjs.com/package/cypress-mochawesome-reporter) [![node](https://img.shields.io/node/v/cypress-mochawesome-reporter.svg)](https://github.com/LironEr/cypress-mochawesome-reporter) [![npm](https://img.shields.io/npm/l/cypress-mochawesome-reporter)](http://www.npmjs.com/package/cypress-mochawesome-reporter) [![npm](https://img.shields.io/npm/dm/cypress-mochawesome-reporter)](http://www.npmjs.com/package/cypress-mochawesome-reporter) Zero config Mochawesome reporter for Cypress with screenshots attached to tests. [Example report](https://lironer.github.io/cypress-mochawesome-reporter/example-report/mochawesome.html) Mochawesome report with fail test screenshot ## Cypress compatibility | reporter version | cypress version | reporter branch | | ---------------- | ----------------------------------------------------------------------------- | ----------------------------------------------------------------------- | | `v5` | node >= 22
>= `6.7.0`
>= `6.2.0` with `experimentalRunEvents: true` | `main` | | `v4` | node >= 22
>= `6.7.0`
>= `6.2.0` with `experimentalRunEvents: true` | [`v4`](https://github.com/LironEr/cypress-mochawesome-reporter/tree/v4) | | `v3` | node >= 14
>= `6.7.0`
>= `6.2.0` with `experimentalRunEvents: true` | [`v3`](https://github.com/LironEr/cypress-mochawesome-reporter/tree/v3) | | `v2` | >= `6.7.0`
>= `6.2.0` with `experimentalRunEvents: true` | [`v2`](https://github.com/LironEr/cypress-mochawesome-reporter/tree/v2) | | `v1` | >= `4.0.0` | [`v1`](https://github.com/LironEr/cypress-mochawesome-reporter/tree/v1) | [migration guide from `v1` to `v2`](./migration.md) ## Setup > This setup tutorial works with Cypress >= v10, looking for older version setup? [here](https://github.com/LironEr/cypress-mochawesome-reporter/blob/9c11e7005351e8750fe48b90d010c9bf29539956/README.md#setup) 1. install cypress-mochawesome-reporter ``` npm i --save-dev cypress-mochawesome-reporter ``` or ``` yarn add -D cypress-mochawesome-reporter ``` 2. Change cypress reporter & setup hooks Edit config file (`cypress.config.js` by default) ```js const { defineConfig } = require('cypress'); module.exports = defineConfig({ reporter: 'cypress-mochawesome-reporter', e2e: { setupNodeEvents(on, config) { require('cypress-mochawesome-reporter/plugin')(on); }, }, }); ``` If you are override `before:run` or `after:run` hooks, use this: ```js const { defineConfig } = require('cypress'); const { beforeRunHook, afterRunHook } = require('cypress-mochawesome-reporter/lib'); module.exports = defineConfig({ reporter: 'cypress-mochawesome-reporter', e2e: { setupNodeEvents(on, config) { on('before:run', async (details) => { console.log('override before:run'); await beforeRunHook(details); }); on('after:run', async () => { console.log('override after:run'); await afterRunHook(); }); }, }, }); ``` 3. Add to `cypress/support/e2e.js` ```javascript import 'cypress-mochawesome-reporter/register'; ``` 4. (optional, if your are using `cypress-cucumber-preprocessor`) Add to `cypress/support/step_definitions/index.js` ```javascript import 'cypress-mochawesome-reporter/cucumberSupport'; ``` > ⚠️ `cypress-cucumber-preprocessor` uses the same hooks as `cypress-mochawesome-reporter`, you also need to install [cypress-on-fix](https://github.com/bahmutov/cypress-on-fix). Full example of using `cypress-mochawesome-reporter` with `cypress-cucumber-preprocessor` can be found [here](examples/cucumber). 5. run cypress ## Custom options If you want to customize your HTML report with [mochawesome-report-generator flags](https://github.com/adamgruber/mochawesome-report-generator#cli-flags) just add the flags you want to `reporterOptions` ```js const { defineConfig } = require('cypress'); module.exports = defineConfig({ reporter: 'cypress-mochawesome-reporter', reporterOptions: { charts: true, reportPageTitle: 'custom-title', embeddedScreenshots: true, inlineAssets: true, saveAllAttempts: false, }, e2e: { setupNodeEvents(on, config) { require('cypress-mochawesome-reporter/plugin')(on); }, }, }); ``` Additional reporter options: | name | type | default | description | | --------------------- | --------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `embeddedScreenshots` | `boolean` | `false` | Embedded external screenshots into HTML using base64, use with `inlineAssets` option to produce a single HTML file | | `ignoreVideos` | `boolean` | `false` | Will not copy videos recorded by Cypress nor show them in the mochawesome report. Requires that Cypress config option `video` is set to `true` for the option to have any effect
Because mochawesome doesn't support context per spec file, each test will have the whole spec file video. More info can be found [here](https://github.com/LironEr/cypress-mochawesome-reporter/issues/43) | | `videoOnFailOnly` | `boolean` | `false` | If Videos are recorded and added to the report, setting this to `true` will add the videos only to tests with failures.
Do note that this will NOT cause video's to only record failed tests, just they not be added to passed tests in the mochawesome report | | `quiet` | `boolean` | `false` | Silence console messages | | `saveAllAttempts` | `boolean` | `true` | Save screenshots of all test attempts, set to `false` to save only the last attempt | | `debug` | `boolean` | `false` | Creates log file with debug data | | `saveJson` | `boolean` | `false` | Keeps the json file used to create html report | ## Add extra information to report Add extra information to the report manually by using `cy.addTestContext()` as seen in the [simple-typescript example test 2](/examples/simple-typescript/cypress/e2e/test2.cy.ts) Mochawesome report with fail test screenshot ## Examples 1. [Simple use of `cypress-mochawesome-reporter`](examples/simple) 2. [Using `cypress-multi-reporters`](examples/multiple-reporters) 3. [With `mochawesome-report-generator` flags](examples/mochawesome-flags) 4. [Change default screenshots folder in `cypress.json`](examples/screenshots-folder) 5. [Using `cypress-mochawesome-reporter` with typescript](examples/simple-typescript) 6. [Using `cypress-mochawesome-reporter` with `cypress-parallel`](examples/cypress-parallel) 7. [Using `cypress-mochawesome-reporter` with `cypress-cucumber-preprocessor`](examples/cucumber) Run `npm i` in root directory then: ``` cd examples/ npm i npm test ``` --- _Source: https://npm.io/package/cypress-mochawesome-reporter · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._