DEV Community

LironEr
LironEr

Posted on • Updated on

Cypress HTML reports with screenshots made easy

TL;DR install cypress-mochawesome-reporter to easily generate Cypress HTML report with screenshots attached to failed tests.


4 June 2022: Post updated to be compatible with cypress v10

28 March 2021: Post updated to the latest (v2) cypress-mochawesome-reporter version

The problem

If you ran Cypress with cypress run command and one / many of your tests failed you will get an error message like this:

test summary

then you're going to need to scroll up until you find all your errors and try to understand what went wrong 😟

test fail error message

wouldn't it be great to see the report on a website? 🤔

Introducing cypress-mochawesome-reporter

A zero-config Mochawesome reporter for Cypress with screenshots attached to failed tests.

With a few simple steps, you will get a report that you can read easily on a website.

Mochawesome report with screenshot

If you are using cypress < 10.0.0 you can use older version of this reporter, read here for more info

Step 1: install cypress-mochawesome-reporter

npm i --save-dev cypress-mochawesome-reporter
yarn add -D cypress-mochawesome-reporter
Enter fullscreen mode Exit fullscreen mode

Step 2: Change cypress reporter & setup hooks

Edit config file (cypress.config.js by default)

const { defineConfig } = require('cypress');

module.exports = defineConfig({
  reporter: 'cypress-mochawesome-reporter',
  e2e: {
    setupNodeEvents(on, config) {
      require('cypress-mochawesome-reporter/plugin')(on);
    },
  },
});
Enter fullscreen mode Exit fullscreen mode

Step 3: Add to cypress/support/e2e.js

import 'cypress-mochawesome-reporter/register';
Enter fullscreen mode Exit fullscreen mode

Run Cypress

That's it! 🎉🎉

For more info & different setup options go to GitHub repo


Only keep reading if you want to find out what this library encapsulates 🤓

Generating an HTML report

Adding Mochawesome reporter to Cypress will generate a website with the test report.

Installation steps in general:

  1. install mochawesome, mochawesome-merge and mochawesome-report-generator.
  2. config Mochawesome reporter.
  3. merge Mochawesome reports into one JSON file.
  4. generate an HTML report based on that file.

Mochawesome report with screenshot

Add screenshots to the report

When a test fails Cypress saves a screenshot in cypress/screenshots folder, so we are going to need to add the screenshot for each failed test.

  1. listen for test:after:run .
  2. calculate the path of the screenshot.
  3. call the addContext method from Mochawesome.

A more detailed tutorial of how to do these steps manually can be found here

Hope you find it helpful (:

Top comments (3)

Collapse
 
ganeshsirsi profile image
Ganesh • Edited

If you are beginner and looking for a more detailed article with options please use the below article.
This article uses the same plugin. Explained in a detailed way helpful for beginners.
dev.to/ganeshsirsi/cypress-how-to-...

Collapse
 
ambrt profile image
Rik

Thanks for posting this.

Btw. there is typo in npm i --save-dev cypress-mochaewsome-reporter

Collapse
 
lironer profile image
LironEr

Fixed, thanks!