mochawesome-screenshots

This is a fork of mochawesome-screenshots with added promise hooks which is itself a fork of Mochawesome(MochawesomePlusPlus) reporter with added screenshots functionality for Protractor. The reporter takes a screenshot after each failed Protractor test.

Installation of the module:

$ npm install [email protected] --save-dev

Usage remains the same as the Mocahwesome.

In your Protractor configuration file:

  framework: 'mocha',

  mochaOpts: {
      reporter: 'mochawesome-screenshots',
      reporterOptions: {
          reportDir: 'customReportDir',
          reportName: 'customReportName',
          reportTitle: 'customReportTitle',
          reportPageTitle: 'customReportPageTitle',
          takePassedScreenshot: false,
          clearOldScreenshots: true,
          shortScrFileNames: false,
          jsonReport: false,
          multiReport: false
      },
      timeout: 600000
  },

Use 'multiReport = true' for parallel test execution (adding timestamp in report file name), or change report name in tests or hooks for shardTestFiles option:

const logReport = require('mochawesome-screenshots/logReport');
    
it('Change report name', function() {
    logReport.setReportName(this, 'customReportName');
});

By default the name of the report will be set to the title of the parent of the test (usually a suite) at the beginning of the test.

To make sure that the driver is not closed before the screenshots are ready, you should wait for all promises returned by Mochawesome.getPromises() to be resolved. E.g. in your protractor configuration file add:

onComplete() {
    return Promise.all(require('mochawesome-screenshots/mochawesome').getPromises());
}

Log data to report:

const logReport = require('mochawesome-screenshots/logReport');

it('Log build number', function() {
    logReport.log(this, 'build number:' + buildNumber);
});

Add custom screenshot from mochawesome-reports/screenshots folder to report:

it('Custom screenshot', function() {
    ..
    save screenshot to ('./mochawesome-reports/screenshots/'+imageFileName);
    ..
    logReport.setScreenshot(this, imageFileName);
});