npm package: @mdeeter/wdio-cucumber-parallel-execution
Description: WebdriverIO Package to execute  Cucumber scenarios in parallel
Author: mdeeter
Latest version: 3.7.2

# wdio-cucumber-parallel-execution

> **Note:** This is a fork of [SimitTomar/wdio-cucumber-parallel-execution](https://github.com/SimitTomar/wdio-cucumber-parallel-execution) with additional updates and maintenance.

### Changes in this fork from original repo

`ff` supports multiple feature paths

---

A WebdriverIO capability for running **Cucumber** scenarios within **Single/Multiple** Feature Files in parallel.

The capability Segregates the entire Automation Suite into smallest independent chunks (Scenarios) and spawns numerous threads through WebdriverIOs maxInstances feature,thus reducing the Test Execution time drastically and allowing Teams to release much faster.

The Solution is Compatible with multiple versions of Nodejs (Ones supporting Async Await natively as well as ones which do not support it)

Handles merging of reports out of the box and provides a consolidated JSON Report Array, which can be leveraged for Reporting.

**Star the repo if you find it useful :)**

# Installation

```
npm install @mdeeter/wdio-cucumber-parallel-execution --save-dev
```

# Architectural View

![ParallelExecution](parallelExecution.png)

Assuming 1 Scenario takes 1 minute on Average, Total Execution Time will be 1 minute for 9 Scenarios since  all 9 Scenarios will get executed in parallel

# API

The Module contains the following functions:

### performSetup

This Feature Creates/Removes the Spec and Temp Folders and puts every Scenario in a seperate Feature File

| Parameter                | Type         | Details                                                                                         |
| ------------------------ | ------------ | ----------------------------------------------------------------------------------------------- |
| sourceSpecDirectory      | string       | relative path to feature directory.                                                             |
| tmpSpecDirectory         | string       | Path to temp folder containing the Temporary Feature Files (Gets removed in the next execution) |
| tagExpression (optional) | string.      | Tag expression to parse                                                                         |
| ff (optional)            | string/array | feature file(s) - relative paths from source to feature file(s)                                 |
| lang (optional)          | string       | Language of sourceSpecDirectory                                                                 |
| cleanTmpSpecDirectory    | Boolean.     | Boolean for cleaning the Temp Spec Directory                                                    |

### getConsolidatedArray

This Feature clubs the JSON Objects generated by every splitted Feature File and returns a consolidated JSON Array, which can be used for Reporting.

| Parameter                        | Type   | Details                                                                         |
| -------------------------------- | ------ | ------------------------------------------------------------------------------- |
| parallelExecutionReportDirectory | string | Path to Parallel Execution Report Directory where all the Reports will be saved |

# Usage

### Setup

Say, in your webdriverio's config file, put the following code:

`wdio.conf.js`

```javascript
const argv = require("yargs").argv;
const wdioParallel = require("wdio-cucumber-parallel-execution");
// The below module is used for cucumber html report generation
const reporter = require("cucumber-html-reporter");
const currentTime = new Date().toJSON().replace(/:/g, "-");

const sourceSpecDirectory = `path/to/featureFilesDirectory`;
const parallelExecutionReportDirectory = `path/to/parallelExecutionReportDirectory`;

let featureFilePath = `${sourceSpecDirectory}/*.feature`;

// If parallel execution is set to true, then create the Split the feature files
// And store then in a tmp spec directory (created inside `the source spec directory)
if (argv.parallel === "true") {
  tmpSpecDirectory = `${sourceSpecDirectory}/tmp`;
  wdioParallel.performSetup({
    sourceSpecDirectory: sourceSpecDirectory,
    tmpSpecDirectory: tmpSpecDirectory,
    cleanTmpSpecDirectory: true,
    splitScenarioOutLineMultipleExamples: true,
  });
  featureFilePath = `${tmpSpecDirectory}/*.feature`;
}
```

#### Alternatively use ff to assign individual feature files

```javascript
const argv = require("yargs").argv;
const wdioParallel = require("wdio-cucumber-parallel-execution");
// The below module is used for cucumber html report generation
const reporter = require("cucumber-html-reporter");
const currentTime = new Date().toJSON().replace(/:/g, "-");

const sourceSpecDirectory = `path/to/featureFilesDirectory`;
const parallelExecutionReportDirectory = `path/to/parallelExecutionReportDirectory`;

let featureFilePath = `${sourceSpecDirectory}/*.feature`;

// If parallel execution is set to true, then create the Split the feature files
// And store then in a tmp spec directory (created inside `the source spec directory)
if (argv.parallel === "true") {
  tmpSpecDirectory = `${sourceSpecDirectory}/tmp`;
  wdioParallel.performSetup({
    sourceSpecDirectory: sourceSpecDirectory,
    ff: "relative/path/from/source/to/feature-file.feature",
    // or an array....
    ff: [
      "relative/path/from/source/to/feature-file1.feature",
      "relative/path/from/source/to/feature-file2.feature",
    ],
    tmpSpecDirectory: tmpSpecDirectory,
    cleanTmpSpecDirectory: true,
  });
  featureFilePath = `${tmpSpecDirectory}/*.feature`;
}
```

### Get Consolidated JSON Report Array

`wdio.conf.js`

```javascript
exports.config = {
  // Runner Configuration

  /**
   * Gets executed once before all workers get launched.
   * @param {Object} config wdio configuration object
   * @param {Array.<Object>} capabilities list of capabilities details
   */
  onPrepare: () => {
    // Remove the `tmp/` folder that holds the json report files
    removeSync(parallelExecutionReportDirectory);
  },

  /**
   * Gets executed after all workers got shut down and the process is about to exit. An error
   * thrown in the onComplete hook will result in the test run failing.
   * @param {Object} exitCode 0 - success, 1 - fail
   * @param {Object} config wdio configuration object
   * @param {Array.<Object>} capabilities list of capabilities details
   * @param {<Object>} results object containing test results
   */
  onComplete: () => {
    try {
      let consolidatedJsonArray = wdioParallel.getConsolidatedData({
        parallelExecutionReportDirectory: parallelExecutionReportDirectory,
      });

      let jsonFile = `${parallelExecutionReportDirectory}report.json`;
      fs.writeFileSync(jsonFile, JSON.stringify(consolidatedJsonArray));

      // The below code is not part of wdio-cucumber-parallel-execution module
      // but is mentioned to show, how it can be used with other reporting modules
      var options = {
        theme: "bootstrap",
        jsonFile: jsonFile,
        output: `tests/reports/html/report-${currentTime}.html`,
        reportSuiteAsScenarios: true,
        scenarioTimestamp: true,
        launchReport: true,
        ignoreBadJsonFile: true,
      };

      reporter.generate(options);
    } catch (err) {
      console.log("err", err);
    }
  },
};
```

### Pass parallel execution Flag as true

`package.json`

```json
  "scripts": {
    "test": "command to run your tests with --parallel=true"
  }

```

# License

(The MIT License)

Copyright (c) 2019 Simit Tomar simittomar8@gmail.com

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Copyright (c) 2019 Alexander Galichenko

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.