testaro 75.1.0 → 75.2.1

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.1",
   "description": "Run 1300 web accessibility tests from 10 tools and get a standardized report",
   "main": "index.js",
   "scripts": {

package/procs/catalog.js

@@ -35,7 +35,7 @@ exports.getCatalog = async report => {
   const targetURL = report.target?.url;
   // If the report specifies a global browser ID and a global target URL:
   if (browserID && targetURL) {
-    // Launch a browser, navigate to the target, and get the resulting page.
+    // Launch a browser and visit the target, or abort the job on failure.
     const page = await launch({
       report,
       actIndex: null,
@@ -159,7 +159,7 @@ exports.getCatalog = async report => {
       return catalog;
     }
     // Otherwise, i.e. if the launch or navigation failed, report and return this.
-    console.log('ERROR: Launch or navigation failure prevented catalog creation');
+    console.log('ERROR: Launch or navigation failure prevented cataloguing and aborted job');
     return {};
   }
   // Otherwise, i.e. if the report specification is incomplete, report and return this.

package/procs/launch.js

@@ -132,6 +132,7 @@ const goTo = exports.goTo = async (report, page, url, timeout, waitUntil) => {
       const actualURL = page.url();
       const actualNorm = actualURL.startsWith('file:') ? normalizeURL(actualURL) : actualURL;
       const urlNorm = url.startsWith('file:') ? normalizeURL(url) : url;
+      const title = await page.title();
       // If the browser was redirected in violation of a strictness requirement:
       if (report.strict && deSlash(actualNorm) !== deSlash(urlNorm)) {
         // Return an error.
@@ -141,6 +142,15 @@ const goTo = exports.goTo = async (report, page, url, timeout, waitUntil) => {
           error: 'badRedirection'
         };
       }
+      // Otherwise, if the browser was redirected to a CAPTCHA barrier:
+      else if ([urlNorm, title].some(identifier => identifier.includes('captcha'))) {
+        // Return this.
+        console.log(`ERROR: Visit to ${url} redirected to CAPTCHA barrier (${actualURL})`);
+        return {
+          success: false,
+          error: 'captchaBarrier'
+        };
+      }
       // Otherwise, i.e. if no prohibited redirection occurred:
       else {
         // Press the Escape key to dismiss any modal dialog.
@@ -179,6 +189,15 @@ const goTo = exports.goTo = async (report, page, url, timeout, waitUntil) => {
         error: `status429/retryAfterSeconds=${waitSeconds}`
       };
     }
+    // Otherwise, if the response status was a suspension:
+    else if (httpStatus === 202) {
+      // Return this.
+      console.log(`ERROR: Visit to ${url} suspended (status 202)`);
+      return {
+        success: false,
+        error: 'status202'
+      };
+    }
     // Otherwise, i.e. if the response status was otherwise abnormal:
     else {
       // Return an error.
@@ -532,10 +551,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 +585,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 +630,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,
+          actIndex === null ? 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)
   };