testaro 55.5.13 → 56.0.0

package/actSpecs.js

@@ -146,7 +146,7 @@ exports.actSpecs = {
       'Perform tests of a tool',
       {
         which: [true, 'string', 'isTest', 'tool name'],
-        launch: [false, 'object', '', 'if new browser to be launched, properties different from target, browserID, and what of the job'],
+        launch: [false, 'object', '', 'new target, browserID, and/or what, if any'],
         rules: [false, 'array', 'areStrings', 'rule IDs or (for nuVal) specifications, if not all']
       }
     ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "testaro",
-  "version": "55.5.13",
+  "version": "56.0.0",
   "description": "Run 1000 web accessibility tests from 11 tools and get a standardized report",
   "main": "index.js",
   "scripts": {

package/procs/doTestAct.js

@@ -63,8 +63,8 @@ const doTestAct = async () => {
     report,
     debug,
     waits,
-    act.launch.browserID || report.browserID,
-    act.launch.target && act.launch.target.url || report.target.url
+    act.launch && act.launch.browserID || report.browserID,
+    act.launch && act.launch.target && act.launch.target.url || report.target.url
   );
   // If the launch aborted the job:
   if (report.jobData && report.jobData.aborted) {

package/procs/isInlineLink.js

@@ -1,5 +1,5 @@
 /*
-  © 2023–2024 CVS Health and/or one of its affiliates. All rights reserved.
+  © 2023–2025 CVS Health and/or one of its affiliates. All rights reserved.
 
   MIT License
 
@@ -30,6 +30,9 @@
 */
 
 exports.isInlineLink = async loc => await loc.evaluate(element => {
+  // Returns the normalized text content of an element.
+  const realTextOf = element => element ? element.textContent.replace(/\s/g, '') : '';
+  const blockElementTypes = 'p, div, li, h1, h2, h3, h4, h5, h6';
   // If the element is not a link:
   if (element.tagName !== 'A' && element.getAttribute('role') !== 'link') {
     // Classify it as not an inline link.
@@ -37,36 +40,16 @@ exports.isInlineLink = async loc => await loc.evaluate(element => {
   }
   // Otherwise, i.e. if it is a link:
   else {
-    let listAncestor;
     // Initialize the link as inline.
     let result = true;
-    // If its display style property is block:
-    const styleDec = window.getComputedStyle(element);
-    if (styleDec.display === 'block') {
+    // If its display style property is block or is tantamount to block:
+    if (
+      window.getComputedStyle(element).display === 'block'
+      || realTextOf(element.closest(blockElementTypes)) === realTextOf(element)
+    ) {
       // Reclassify the link as non-inline.
       result = false;
     }
-    // Otherwise, if it is in a list item in a list of at least 2 links:
-    else if (listAncestor = element.closest('ul, ol')) {
-      if (listAncestor.children.length > 1 && Array.from(listAncestor.children).every(child => {
-        const isValidListItem = child.tagName === 'LI';
-        const has1Link = child.querySelectorAll('a').length === 1;
-        return isValidListItem && has1Link;
-      })) {
-        // If the list text is entirely link text:
-        const listText = listAncestor.textContent.replace(/\s/g, '');
-        let linkTextRaw = '';
-        listAncestor.querySelectorAll('a').forEach(link => {
-          linkTextRaw += link.textContent;
-        });
-        const linkText = linkTextRaw.replace(/\s/g, '');
-        console.log(linkText);
-        if (listText === linkText && listText.length) {
-          // Reclassify the link as non-inline.
-          result = false;
-        }
-      }
-    }
     // Return the result.
     return result;
   }

package/run.js

@@ -246,6 +246,8 @@ const launch = exports.launch = async (report, debug, waits, tempBrowserID, temp
   const url = tempURL || report.target && report.target.url || '';
   // If the specified browser and device types and URL exist:
   if (isBrowserID(browserID) && isDeviceID(deviceID) && isURL(url)) {
+    // Replace the report target URL with this URL.
+    report.target.url = url;
     // Create a browser of the specified or default type.
     const browserType = require('playwright')[browserID];
     // Close the current browser, if any.
@@ -762,6 +764,8 @@ const doActs = async (report) => {
           const navResult = await goTo(report, page, requestedURL, 15000, 'domcontentloaded');
           // If the visit succeeded:
           if (navResult.success) {
+            // Revise the report URL to this URL.
+            report.target.url = requestedURL;
             // Add the script nonce, if any, to the act.
             const {response} = navResult;
             const scriptNonce = getNonce(response);

package/testaro/focVis.js

@@ -1,5 +1,5 @@
 /*
-  © 2022–2024 CVS Health and/or one of its affiliates. All rights reserved.
+  © 2022–2025 CVS Health and/or one of its affiliates. All rights reserved.
 
   MIT License
 
@@ -25,7 +25,7 @@
 /*
   focVis
   Derived from the bbc-a11y elementsMustBeVisibleOnFocus test.
-  This test reports links that are off the display when focused.
+  This test reports links that are at least partly off the display when focused.
 */
 
 // ########## IMPORTS
@@ -37,35 +37,30 @@ const {init, report} = require('../procs/testaro');
 
 // Runs the test and returns the result.
 exports.reporter = async (page, withItems) => {
-  // Initialize the locators and result.
+  // Initialize a sample of locators and a result.
   const all = await init(100, page, 'a:visible');
   // For each locator:
   for (const loc of all.allLocs) {
+    // Focus it.
+    await loc.focus();
+    // Get its location.
+    const box = await loc.boundingBox();
     // Get how its element violates the rule, if it does.
-    try {
-      const isBad = await loc.evaluate(el => {
-        const isAbove = el.offsetTop + el.offsetHeight <= 0;
-        const isLeft = el.offsetLeft + el.offsetWidth <= 0;
-        return [isAbove, isLeft];
-      }, {timeout: 500});
-      // If it does:
-      if (isBad[0] || isBad[1]) {
-        // Add the locator to the array of violators.
-        let param;
-        if (isBad[0] && isBad[1]) {
-          param = 'above and to the left of';
-        }
-        else if (isBad[0]) {
-          param = 'above';
-        }
-        else {
-          param = 'to the left of';
-        }
-        all.locs.push([loc, param]);
+    const isBad = [box.x < 0, box.y < 0];
+    // If it does:
+    if (isBad.some(item => item)) {
+      // Add the locator to the array of violators.
+      let param;
+      if (isBad.every(item => item)) {
+        param = 'above and to the left of';
       }
-    }
-    catch(error) {
-      console.log(`ERROR analyzing locator for focVis (${error.message})`);
+      else if (isBad[0]) {
+        param = 'to the left of';
+      }
+      else {
+        param = 'above';
+      }
+      all.locs.push([loc, param]);
     }
   }
   // Populate and return the result.

package/tests/testaro.js

@@ -38,6 +38,7 @@ const {tellServer} = require('../procs/tellServer');
 
 // ######## CONSTANTS
 
+// The validation job data for the tests listed below are in the pending directory.
 /*
 const futureEvalRulesTraining = {
   altScheme: 'img elements with alt attributes having URLs as their entire values',
@@ -81,7 +82,7 @@ const evalRules = {
   focAll: 'discrepancies between focusable and Tab-focused elements',
   focInd: 'missing and nonstandard focus indicators',
   focOp: 'Tab-focusable elements that are not operable',
-  focVis: 'links that are invisible when focused',
+  focVis: 'links that are not entirely visible when focused',
   headEl: 'invalid elements within the head',
   headingAmb: 'same-level sibling headings with identical texts',
   hover: 'hover-caused content changes',

package/validation/done/README.md

@@ -1,3 +1,3 @@
 # exJobs
 
-Directory into which executor `watchDir` archives jobs.
+Directory into which executor `dirWatch` archives jobs.

package/validation/tests/{jobs → jobProperties}/allCaps.json

@@ -1,14 +1,13 @@
 {
-  "id": "allCaps",
-  "what": "validation of allCaps test",
-  "strict": true,
+  "rule": "allCaps",
   "timeLimit": 20,
   "acts": [
     {
       "type": "launch",
-      "which": "chromium",
-      "url": "file://validation/tests/targets/allCaps/index.html",
-      "what": "page with various letter cases"
+      "target": {
+        "url": "file://validation/tests/targets/allCaps/index.html",
+        "what": "page with various letter cases"
+      }
     },
     {
       "type": "test",
@@ -134,11 +133,5 @@
         "allCaps"
       ]
     }
-  ],
-  "sources": {
-  },
-  "standard": "only",
-  "observe": false,
-  "timeStamp": "240101T1500",
-  "creationTimeStamp": "240101T1200"
+  ]
 }

package/validation/tests/{jobs → jobProperties}/allHidden.json

@@ -1,14 +1,13 @@
 {
-  "id": "allHidden",
-  "what": "validation of allHidden test",
-  "strict": true,
+  "rule": "allHidden",
   "timeLimit": 20,
   "acts": [
     {
       "type": "launch",
-      "which": "chromium",
-      "url": "file://validation/tests/targets/allHidden/good.html",
-      "what": "page with nothing hidden"
+      "target": {
+        "url": "file://validation/tests/targets/allHidden/good.html",
+        "what": "page with nothing hidden"
+      }
     },
     {
       "type": "test",
@@ -307,11 +306,5 @@
         "allHidden"
       ]
     }
-  ],
-  "sources": {
-  },
-  "standard": "only",
-  "observe": false,
-  "timeStamp": "240101T1500",
-  "creationTimeStamp": "240101T1200"
+  ]
 }

package/validation/tests/{jobs → jobProperties}/allSlanted.json

@@ -1,14 +1,13 @@
 {
-  "id": "allSlanted",
-  "what": "validation of allSlanted test",
-  "strict": true,
+  "rule": "allSlanted",
   "timeLimit": 20,
   "acts": [
     {
       "type": "launch",
-      "which": "chromium",
-      "url": "file://validation/tests/targets/allSlanted/index.html",
-      "what": "page with various slantednesses"
+      "target": {
+        "url": "file://validation/tests/targets/allSlanted/index.html",
+        "what": "page with various slantednesses"
+      }
     },
     {
       "type": "test",
@@ -129,11 +128,5 @@
         "allSlanted"
       ]
     }
-  ],
-  "sources": {
-  },
-  "standard": "only",
-  "observe": false,
-  "timeStamp": "240101T1500",
-  "creationTimeStamp": "240101T1200"
+  ]
 }

package/validation/tests/{jobs → jobProperties}/attVal.json

@@ -1,14 +1,13 @@
 {
-  "id": "attVal",
-  "what": "validation of attVal test",
-  "strict": true,
+  "rule": "attVal",
   "timeLimit": 20,
   "acts": [
     {
       "type": "launch",
-      "which": "chromium",
-      "url": "file://validation/tests/targets/attVal/good.html",
-      "what": "page with permitted attribute values"
+      "target": {
+        "url": "file://validation/tests/targets/attVal/good.html",
+        "what": "page with permitted attribute values"
+      }
     },
     {
       "type": "test",
@@ -180,11 +179,5 @@
         "attVal": ["lang", true, ["en-US", "de-CH"]]
       }
     }
-  ],
-  "sources": {
-  },
-  "standard": "only",
-  "observe": false,
-  "timeStamp": "240101T1500",
-  "creationTimeStamp": "240101T1200"
+  ]
 }

package/validation/tests/{jobs → jobProperties}/autocomplete.json

@@ -1,14 +1,13 @@
 {
-  "id": "autocomplete",
-  "what": "validation of autocomplete test",
-  "strict": true,
+  "rule": "autocomplete",
   "timeLimit": 20,
   "acts": [
     {
       "type": "launch",
-      "which": "chromium",
-      "url": "file://validation/tests/targets/autocomplete/good.html",
-      "what": "page with correct autocomplete attributes"
+      "target": {
+        "url": "file://validation/tests/targets/autocomplete/good.html",
+        "what": "page with correct autocomplete attributes"
+      }
     },
     {
       "type": "test",
@@ -144,11 +143,5 @@
         "autocomplete"
       ]
     }
-  ],
-  "sources": {
-  },
-  "standard": "only",
-  "observe": false,
-  "timeStamp": "240101T1500",
-  "creationTimeStamp": "240101T1200"
+  ]
 }

package/validation/tests/{jobs → jobProperties}/bulk.json

@@ -1,14 +1,13 @@
 {
-  "id": "bulk",
-  "what": "validation of bulk test",
-  "strict": true,
+  "rule": "bulk",
   "timeLimit": 20,
   "acts": [
     {
       "type": "launch",
-      "which": "chromium",
-      "url": "file://validation/tests/targets/bulk/good.html",
-      "what": "small page"
+      "target": {
+        "url": "file://validation/tests/targets/bulk/good.html",
+        "what": "small page"
+      }
     },
     {
       "type": "test",
@@ -79,11 +78,5 @@
         "bulk"
       ]
     }
-  ],
-  "sources": {
-  },
-  "standard": "only",
-  "observe": false,
-  "timeStamp": "240101T1500",
-  "creationTimeStamp": "240101T1200"
+  ]
 }

package/validation/tests/{jobs → jobProperties}/buttonMenu.json

@@ -1,14 +1,13 @@
 {
-  "id": "buttonMenu",
-  "what": "validation of buttonMenu test",
-  "strict": true,
+  "rule": "buttonMenu",
   "timeLimit": 20,
   "acts": [
     {
       "type": "launch",
-      "which": "chromium",
-      "url": "file://validation/tests/targets/buttonMenu/good.html",
-      "what": "page with standard menu navigation"
+      "target": {
+        "url": "file://validation/tests/targets/buttonMenu/good.html",
+        "what": "page with standard menu navigation"
+      }
     },
     {
       "type": "test",
@@ -207,11 +206,5 @@
         "buttonMenu"
       ]
     }
-  ],
-  "sources": {
-  },
-  "standard": "only",
-  "observe": false,
-  "timeStamp": "240101T1500",
-  "creationTimeStamp": "240101T1200"
+  ]
 }

package/validation/tests/{jobs → jobProperties}/distortion.json

@@ -1,14 +1,13 @@
 {
-  "id": "distortion",
-  "what": "validation of distortion test",
-  "strict": true,
+  "rule": "distortion",
   "timeLimit": 20,
   "acts": [
     {
       "type": "launch",
-      "which": "chromium",
-      "url": "file://validation/tests/targets/distortion/index.html",
-      "what": "page with distorted text"
+      "target": {
+        "url": "file://validation/tests/targets/distortion/index.html",
+        "what": "page with distorted text"
+      }
     },
     {
       "type": "test",
@@ -104,11 +103,5 @@
         "distortion"
       ]
     }
-  ],
-  "sources": {
-  },
-  "standard": "only",
-  "observe": false,
-  "timeStamp": "240101T1500",
-  "creationTimeStamp": "240101T1200"
+  ]
 }

package/validation/tests/{jobs → jobProperties}/docType.json

@@ -1,14 +1,13 @@
 {
-  "id": "docType",
-  "what": "validation of docType test",
-  "strict": true,
+  "rule": "docType",
   "timeLimit": 20,
   "acts": [
     {
       "type": "launch",
-      "which": "chromium",
-      "url": "file://validation/tests/targets/docType/good.html",
-      "what": "page with doctype"
+      "target": {
+        "url": "file://validation/tests/targets/docType/good.html",
+        "what": "page with doctype"
+      }
     },
     {
       "type": "test",
@@ -84,11 +83,5 @@
         "docType"
       ]
     }
-  ],
-  "sources": {
-  },
-  "standard": "only",
-  "observe": false,
-  "timeStamp": "240101T1500",
-  "creationTimeStamp": "240101T1200"
+  ]
 }

package/validation/tests/{jobs → jobProperties}/dupAtt.json

@@ -1,14 +1,13 @@
 {
-  "id": "dupAtt",
-  "what": "validation of dupAtt test",
-  "strict": true,
+  "rule": "dupAtt",
   "timeLimit": 20,
   "acts": [
     {
       "type": "launch",
-      "which": "chromium",
-      "url": "file://validation/tests/targets/dupAtt/good.html",
-      "what": "page without duplicate attributes"
+      "target": {
+        "url": "file://validation/tests/targets/dupAtt/good.html",
+        "what": "page without duplicate attributes"
+      }
     },
     {
       "type": "test",
@@ -131,11 +130,5 @@
         "dupAtt"
       ]
     }
-  ],
-  "sources": {
-  },
-  "standard": "only",
-  "observe": false,
-  "timeStamp": "240101T1500",
-  "creationTimeStamp": "240101T1200"
+  ]
 }

package/validation/tests/{jobs → jobProperties}/elements.json

@@ -1,14 +1,13 @@
 {
-  "id": "elements",
-  "what": "validation of elements test",
-  "strict": true,
+  "rule": "elements",
   "timeLimit": 20,
   "acts": [
     {
       "type": "launch",
-      "which": "chromium",
-      "url": "file://validation/tests/targets/elements/index.html",
-      "what": "page with a shadow root"
+      "target": {
+        "url": "file://validation/tests/targets/elements/index.html",
+        "what": "page with a shadow root"
+      }
     },
     {
       "type": "test",
@@ -293,10 +292,5 @@
       }
     }
   ],
-  "sources": {
-  },
-  "standard": "no",
-  "observe": false,
-  "timeStamp": "240101T1500",
-  "creationTimeStamp": "240101T1200"
+  "standard": "no"
 }

package/validation/tests/{jobs → jobProperties}/embAc.json

@@ -1,14 +1,13 @@
 {
-  "id": "embAc",
-  "what": "validation of embAc test",
-  "strict": true,
+  "rule": "embAc",
   "timeLimit": 20,
   "acts": [
     {
       "type": "launch",
-      "which": "chromium",
-      "url": "file://validation/tests/targets/embAc/good.html",
-      "what": "page without embedding in links or buttons"
+      "target": {
+        "url": "file://validation/tests/targets/embAc/good.html",
+        "what": "page without embedding in links or buttons"
+      }
     },
     {
       "type": "test",
@@ -141,11 +140,5 @@
         "embAc"
       ]
     }
-  ],
-  "sources": {
-  },
-  "standard": "only",
-  "observe": false,
-  "timeStamp": "240101T1500",
-  "creationTimeStamp": "240101T1200"
+  ]
 }

package/validation/tests/{jobs → jobProperties}/focAll.json

@@ -1,14 +1,13 @@
 {
-  "id": "focAll",
-  "what": "validation of focAll test",
-  "strict": true,
+  "rule": "focAll",
   "timeLimit": 20,
   "acts": [
     {
       "type": "launch",
-      "which": "chromium",
-      "url": "file://validation/tests/targets/focAll/good.html",
-      "what": "fully Tab-focusable page"
+      "target": {
+        "url": "file://validation/tests/targets/focAll/good.html",
+        "what": "fully Tab-focusable page"
+      }
     },
     {
       "type": "test",
@@ -126,11 +125,5 @@
         "focAll"
       ]
     }
-  ],
-  "sources": {
-  },
-  "standard": "only",
-  "observe": false,
-  "timeStamp": "240101T1500",
-  "creationTimeStamp": "240101T1200"
+  ]
 }