testaro 75.1.0 → 75.2.0

package/env.example

@@ -14,19 +14,20 @@ WAITS=0
 NODE_OPTIONS='--trace-uncaught --trace-warnings'
 # Suppresses a routine warning from QualWeb.
 PUPPETEER_DISABLE_HEADLESS_WARNING=true
+# Replace the next 2 placeholders with http://localhost:3000 if Kilotest and Testaro are on the same host or the URL of the server (e.g., https://kilotest.com) if they are on different hosts.
 # URL to poll for available jobs when watching the network.
-NETWATCH_JOB=__placeholder__/api/testaro-agent/job
+NETWATCH_URL_JOB=__placeholder__/api/testaro-agent/job
 # URL to report results to when watching the network.
-NETWATCH_REPORT=__placeholder__/api/testaro-agent/report
+NETWATCH_URL_REPORT=__placeholder__/api/testaro-agent/report
 # Password of this Testaro agent
-NETWATCH_AUTH=__placeholder__
+NETWATCH_URL_AUTH=__placeholder__
 # Directory (relative to project root) to watch for jobs.
 JOBDIR=__placeholder__
 # Directory (relative to project root) to write reports to when watching a directory for jobs.
 REPORTDIR=__placeholder__
 # Multiplier for time limits (normally 1).
 TIMEOUT_MULTIPLIER=1
-# Whether to abort the job when any test act fork crashes (default false).
+# Whether to abort the job when launch retries are exhausted or a test act crashes (default false).
 ABORT_ASSERTIVELY=false
 # URL of any non-default (e.g., self-hosted) Nu Html Checker API (see ghcr.io/validator/validator).
 TESTARO_NU_URL=__placeholder__

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "testaro",
-  "version": "75.1.0",
+  "version": "75.2.0",
   "description": "Run 1300 web accessibility tests from 10 tools and get a standardized report",
   "main": "index.js",
   "scripts": {

package/procs/launch.js

@@ -532,10 +532,10 @@ const launchOnce = async opts => {
 };
 // Manages browser launching and navigating and returns a page.
 exports.launch = async (opts = {}) => {
+  let {tempBrowserID = ''} = opts;
   const {
     report = {},
     actIndex = 0,
-    tempBrowserID = '',
     tempURL = '',
     headEmulation = 'high',
     xPathNeed = 'script',
@@ -566,6 +566,7 @@ exports.launch = async (opts = {}) => {
     }
     // Otherwise, i.e. if the launch or navigation failed:
     else {
+      let unusedBrowserIDs = ['chromium', 'webkit', 'firefox'].filter(id => id !== tempBrowserID);
       let retriesLeft = retries;
       let {error} = launchResult;
       // As long as retries remain, decrement the allowed retry count and:
@@ -610,13 +611,25 @@ exports.launch = async (opts = {}) => {
           error = launchResult.error;
           // Report this.
           console.log(`WARNING: Retry failed (${error})`);
+          // If a browser type was specified, retries are exhausted, and browser types are not:
+          if (tempBrowserID && unusedBrowserIDs.length && ! retriesLeft) {
+            // Change the browser type.
+            tempBrowserID = unusedBrowserIDs.shift();
+            console.log(`NOTICE: Changing browser type to ${tempBrowserID}`);
+            // Reset the retries.
+            retriesLeft = retries;
+          }
         }
       }
-      // If the retries were exhausted:
+      // If the retries were finally exhausted:
       if (! retriesLeft) {
         // Report this and, if so configured, that the job was aborted.
         addError(
-          true, abortAssertively, report, actIndex, `Launch or navigation failed; retries exhausted`
+          true,
+          abortAssertively,
+          report,
+          actIndex,
+          `Launch or navigation failed; retries and browser types exhausted`
         );
       }
       // Return a failure.

package/procs/shoot.js

@@ -29,7 +29,6 @@ const randomFileName = (suffixLength = 3) => {
 const screenShot = async (page, exclusionLocator = null) => {
   const options = {
     fullPage: true,
-    omitBackground: true,
     scale: 'css',
     timeout: applyMultiplier(4000)
   };