[terra-functional-testing] Allow consumers to set maxInstances while executing WDIO.

packages/terra-functional-testing/CHANGELOG.md

@@ -2,6 +2,9 @@
 
 ## Unreleased
 
+* Changed
+  * Allow consumers to set maxInstances while executing wdio scripts.
+
 ## 4.4.0 - (September 26, 2023)
 
 * Changed

packages/terra-functional-testing/src/config/capabilities.js

@@ -1,11 +1,12 @@
 /**
  * This file contains the capability configurations for each supported browser.
  */
+const getMaxInstances = require('./utils/getMaxInstances');
 
 module.exports = {
   chrome: {
     browserName: 'chrome',
-    maxInstances: 1,
+    maxInstances: getMaxInstances(),
     'goog:chromeOptions': {
       /**
        * Run in headless mode because Chrome 69+ cannot be resized to the tiny viewport due to a omnibox size change
@@ -19,7 +20,7 @@ module.exports = {
   },
   firefox: {
     browserName: 'firefox',
-    maxInstances: 1,
+    maxInstances: getMaxInstances(),
     'moz:firefoxOptions': {
       prefs: {
         'dom.disable_beforeunload': false,
@@ -28,7 +29,7 @@ module.exports = {
   },
   ie: {
     browserName: 'internet explorer',
-    maxInstances: 1,
+    maxInstances: getMaxInstances(),
     'se:ieOptions': {
       javascriptEnabled: true,
       locationContextEnabled: true,

packages/terra-functional-testing/src/config/utils/getMaxInstances.js

@@ -0,0 +1,7 @@
+module.exports = () => {
+  const args = process.argv.slice(2);
+  const maxInstancesIndex = args.indexOf('--maxInstances');
+  const maxInstances = maxInstancesIndex !== -1 ? parseInt(args[maxInstancesIndex + 1], 10) : 1;
+
+  return maxInstances;
+};

packages/terra-functional-testing/src/terra-cli/wdio/index.js

@@ -181,6 +181,17 @@ const cli = {
           return ['en'];
         },
       },
+      maxInstances: {
+        type: 'number',
+        describe: 'The number of tests running concurrently.',
+        default: () => {
+          if (process.env.MAX_INSTANCES) {
+            return [process.env.MAX_INSTANCES];
+          }
+
+          return 1;
+        },
+      },
       screenshotUrl: {
         type: 'string',
         describe: 'The url to the registry that stores the screenshots',

packages/terra-functional-testing/tests/jest/terra-cli/wdio/__snapshots__/index.test.js.snap

@@ -44,6 +44,9 @@ Options:
                                                       [boolean] [default: false]
       --locales                         A list of language locales for the test
                                         run.       [array] [default: (_default)]
+      --maxInstances                    The number of tests running
+                                        concurrently.
+                                                  [number] [default: (_default)]
       --screenshotUrl                   The url to the registry that stores the
                                         screenshots
                                                   [string] [default: (_default)]