How to execute cucumber feature file parallel

By | December 31, 2017

I have below feature files (Separate feature files) in src/test/resources/feature/ and I would like to run them in parallel. Like: One feature file has to execute in chrome and another one has to execute in firefox as mentioned @Tags name.

Feature: Refund item

  Scenario: Jeff returns a faulty microwave
    Given Jeff has bought a microwave for $100
    And he has a receipt
    When he returns the microwave
    Then Jeff should be refunded $100

Feature: Refund Money

  Scenario: Jeff returns the money
    Given Jeff has bought a microwave for $100
    And he has a receipt
    When he returns the microwave
    Then Jeff should be refunded $100

Can somebody assist me to achieve this.I’m using cucumber-java 1.2.2 version, and AbstractTestNGCucumberTests using as runner. Also, let me know how can I create a Test Runner dynamically by using feature files and make them run in parallel.


Cucumber does not support parallel execution out of the box.
I’ve tried, but it is not friendly.

  1. We have to use maven’s capability to invoke it in parallel. Refer link
  2. Also there is a github project which uses custom plugin to execute in parallel.
    Refer cucumber-jvm-parallel-plugin

Update: 4.0.0 version is available at maven central repository with bunch of changes.for more details go here.

Update: 2.2.0 version is available at maven central repository.

You can use opensource plugin cucumber-jvm-parallel-plugin which has many advantages over existing solutions. Available at maven repository

  1. First you need to add this plugin with required configuration in your project pom file.

             <!-- Mandatory -->
             <!-- comma separated list of package names to scan for glue code -->
             <glue>foo, bar</glue>
              <!-- The directory, which must be in the root of the runtime classpath, containing your feature files.  -->
              <!-- Directory where the cucumber report files shall be written  -->
              <!-- comma separated list of output formats json,html,rerun.txt -->
              <!-- CucumberOptions.strict property -->
              <!-- CucumberOptions.monochrome property -->
              <!-- The tags to run, maps to CucumberOptions.tags property you can pass ANDed tags like "@tag1","@tag2" and ORed tags like "@tag1,@tag2,@tag3" -->
             <!-- If set to true, only feature files containing the required tags shall be generated. -->
             <!-- Generate TestNG runners instead of default JUnit ones. --> 
             <!-- The naming scheme to use for the generated test classes.  One of 'simple' or 'feature-title' --> 
            <!-- The class naming pattern to use.  Only required/used if naming scheme is 'pattern'.-->
            <!-- One of [SCENARIO, FEATURE]. SCENARIO generates one runner per scenario.  FEATURE generates a runner per feature. -->
            <!-- This is optional, required only if you want to specify a custom template for the generated sources (this is a relative path) -->
  2. Now add below plugin just below above plugin which will invoke runner classes generated by above plugin

  3. Above two plugins will do magic for cucumber test running in parallel (provided you machine also have advanced hardware support).

  4. Strictly provided <forkCount>n</forkCount> here ‘n’ is directly proportional to 1) Advanced Hardware support and 2) you available nodes i.e. registered browser instances to HUB.

  5. One major and most important changes is your WebDriver class must be SHARED and you should not implement driver.quit() method, as closing is take care by shutdown hook.

    import cucumber.api.Scenario;
    import org.openqa.selenium.OutputType;
    import org.openqa.selenium.WebDriver;
    import org.openqa.selenium.WebDriverException;
    import org.openqa.selenium.firefox.FirefoxDriver;
    public class SharedDriver extends EventFiringWebDriver {
        private static WebDriver REAL_DRIVER = null;
        private static final Thread CLOSE_THREAD = new Thread() {
            public void run() {
        static {
        public SharedDriver() {
        public static WebDriver CreateDriver() {
            WebDriver webDriver;
            if (REAL_DRIVER == null)
                webDriver = new FirefoxDriver();
            return webDriver;
        public static void setWebDriver(WebDriver webDriver) {
            this.REAL_DRIVER = webDriver;
        public static WebDriver getWebDriver() {
            return this.REAL_DRIVER;
        public void close() {
            if (Thread.currentThread() != CLOSE_THREAD) {
                throw new UnsupportedOperationException("You shouldn't close this WebDriver. It's shared and will close when the JVM exits.");
        public void deleteAllCookies() {
        public void embedScreenshot(Scenario scenario) {
            try {
                byte[] screenshot = getScreenshotAs(OutputType.BYTES);
                scenario.embed(screenshot, "image/png");
            } catch (WebDriverException somePlatformsDontSupportScreenshots) {
  6. Considering you want to execute more than 50 threads i.e. same no of browser instances are registered to HUB but Hub will die if it doesn’t get enough memory therefore to avoid this critical situation you should start hub with -DPOOL_MAX=512 (or larger) as stated in grid2 documentation.

    Really large (>50 node) Hub installations may need to increase the jetty threads by setting -DPOOL_MAX=512 (or larger) on the java command line.

    java -jar selenium-server-standalone-<version>.jar -role hub -DPOOL_MAX=512


If all you are expecting is to be able to run multiple features in parallel, then you can try doing the following :

  • Duplicate the class AbstractTestNGCucumberTests in your test project and set the attribute parallel=true to the @DataProvider annotated method.

Since the default dataprovider-thread-count from TestNG is 10 and now that you have instructed TestNG to run features in parallel, you should start seeing your feature files get executed in parallel.

But I understand that Cucumber reporting is inherently not thread safe, so your reports may appear garbled.

Leave a Reply

Your email address will not be published. Required fields are marked *