testaro 66.0.0 → 67.0.0

package/README.md

@@ -48,7 +48,7 @@ Testaro uses:
 - [Playwright](https://playwright.dev/) to launch browsers, perform user actions in them, and perform tests
 - [playwright-extra](https://www.npmjs.com/package/playwright-extra) and [puppeteer-extra-plugin-stealth](https://www.npmjs.com/package/puppeteer-extra-plugin-stealth) to make a Playwright-controlled browser more indistinguishable from a human-operated browser and thus make their requests more likely to succeed
 - [playwright-dompath](https://www.npmjs.com/package/playwright-dompath) to retrieve XPaths of elements
-- [pixelmatch](https://www.npmjs.com/package/pixelmatch) to measure motion
+- [BlazeDiff](https://blazediff.dev/) to measure motion
 
 Testaro performs tests of these _tools_:
 

package/UPGRADES.md

@@ -54,7 +54,7 @@ I'll quickly scan for module patterns and JSON imports across the repo to tailor
   - Strategy for optional properties and progressive enrichment during execution.
 
 - **3rd‑party types and augmentations**
-  - Verify/choose type packages for `playwright`, `@siteimprove/alfa-*`, `axe-playwright`, `@qualweb/*`, `accessibility-checker`, `playwright-dompath`, `pixelmatch`. Plan fallbacks if defs are missing.
+  - Verify/choose type packages for `playwright`, `@siteimprove/alfa-*`, `axe-playwright`, `@qualweb/*`, `accessibility-checker`, `playwright-dompath`. Plan fallbacks if defs are missing.
   - Decide on module augmentation vs casting for custom fields (e.g., `page.browserID` assignment requires augmenting `playwright.Page` or casting).
 
 - **Dynamic loading patterns**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "testaro",
-  "version": "66.0.0",
+  "version": "67.0.0",
   "description": "Run 1000 web accessibility tests from 11 tools and get a standardized report",
   "main": "index.js",
   "scripts": {
@@ -30,6 +30,7 @@
   },
   "homepage": "https://github.com/jrpool/testaro#readme",
   "dependencies": {
+    "@blazediff/core": "*",
     "@qualweb/core": "*",
     "@qualweb/act-rules": "*",
     "@qualweb/wcag-techniques": "*",
@@ -43,7 +44,6 @@
     "aslint-testaro": "*",
     "axe-playwright": "*",
     "dotenv": "*",
-    "pixelmatch": "*",
     "playwright": "*",
     "playwright-dompath": "*",
     "playwright-extra": "*",

package/procs/getLocatorData.js

@@ -101,20 +101,52 @@ exports.getLocatorData = async loc => {
     return null;
   }
 };
-// Returns location data from the extract of a standard instance.
-exports.getLocationData = async (page, excerpt) => {
+// Returns properties of an element with an excerpt when Testaro identifiers have been added.
+exports.getElementData = async (page, excerpt) => {
+  // Initialize the properties.
+  let data = {
+    tagName: '',
+    id: '',
+    text: '',
+    notInDOM: true,
+    boxID: '',
+    pathID: '',
+    originalExcerpt: excerpt,
+  };
+  let elementProperties = {};
   const testaroIDArray = excerpt.match(/data-testaro-id="(\d+)#([^"]*)"/);
-  // If the extract contains a Testaro identifier:
+  // If the excerpt contains a Testaro identifier:
   if (testaroIDArray) {
-    return await page.evaluate(testaroIDArray => {
+    // Remove the identifier.
+    originalExcerpt = excerpt.replace(/ data-testaro-id="\d+#[^" ]+"?/, '');
+    elementProperties = await page.evaluate(testaroIDArray => {
+      let tagName = '';
+      let id = '';
+      const text = [];
+      let notInDOM = false;
+      let boxID = '';
+      let pathID = '';
       const testaroID = `${testaroIDArray[1]}#${testaroIDArray[2]}`;
       const element = document.querySelector(`[data-testaro-id="${testaroID}"]`);
-      // If any element has that identifier:
+      // If any element has the identifier:
       if (element) {
-        // Get a box ID for the element.
+        // Get properties of the element.
+        ({tagName, id} = element);
+        const segments = element
+          .innerText
+          ?.trim()
+          .split(/[\t\n]+/)
+          .filter(segment => segment.length);
+        if (segments?.length) {
+          if (segments.length > 1) {
+            text.push(segments[0], segments[segments.length - 1]);
+          }
+          else {
+            text.push(segments[0]);
+          }
+        }
+        const boundingBox = element.getBoundingClientRect() ?? {};
         const box = {};
-        let boxID = '';
-        const boundingBox = element.getBoundingClientRect() || {};
         if (boundingBox.x) {
           ['x', 'y', 'width', 'height'].forEach(coordinate => {
             box[coordinate] = Math.round(boundingBox[coordinate]);
@@ -123,41 +155,38 @@ exports.getLocationData = async (page, excerpt) => {
         if (typeof box.x === 'number') {
           boxID = Object.values(box).join(':');
         }
-        // Get a path ID from the Testaro identifier or, if necessary, the element.
-        let pathID = testaroIDArray[2];
+        // Get a path ID from the identifier or, if necessary, the element.
+        pathID = testaroIDArray[2];
         if (! pathID) {
           pathID = window.getXPath(element);
         }
-        // Return the box and path IDs.
-        return {
-          boxID,
-          pathID
-        };
       }
-      // Otherwise, if no element has it but the identifier includes an XPath:
-      else if (testaroIDArray[2]) {
-        // Return an empty box ID and that XPath as a path ID.
-        return {
-          notInDOM: true,
-          boxID: '',
-          pathID: testaroIDArray[2]
-        };
+      // Otherwise, i.e. if no element has the identifier:
+      else {
+        // Report this.
+        notInDOM = true;
       }
-      // Otherwise, return empty location properties.
+      // Report the properties.
       return {
-        notInDOM: true,
-        boxID: '',
-        pathID: ''
+        tagName,
+        id,
+        text,
+        notInDOM,
+        boxID,
+        pathID
       };
     }, testaroIDArray);
+    // Populate the data with any properties obtained from the element.
+    Object.assign(data, elementProperties);
   }
-  // Otherwise, i.e. if the extract contains no Testaro identifier:
+  // Otherwise, i.e. if the excerpt contains no Testaro identifier:
   else {
-    // Return a non-DOM location.
-    return {
-      notInDOM: true,
-      boxID: '',
-      pathID: ''
-    };
+    // Get properties of the element that are gettable from the excerpt.
+    const tagNameArray = excerpt.match(/<([-a-z]+)/);
+    data.tagName = tagNameArray?.[1] ?? '';
+    const idArray = excerpt.match(/ id="([^"]*)"/);
+    data.id = idArray?.[1] ?? '';
   }
+  // Return the properties.
+  return data;
 };

package/procs/identify.js

@@ -56,30 +56,35 @@ const boxToString = exports.boxToString = box => {
 };
 // Normalizes an XPath.
 const getNormalizedXPath = exports.getNormalizedXPath = xPath => {
-  xPath = xPath.replace(/^\.\/\//, '/');
-  const segments = xPath.split('/');
-  // Initialize an array of normalized segments.
-  const normalizedSegments = [];
-  // For each segment of the XPath:
-  segments.forEach(segment => {
-    // If the segment is html[1] or body[1]:
-    if (/html\[1\]|body\[1\]/.test(segment)) {
-      // Add it without its subscript to the array.
-      normalizedSegments.push(segment.replace(/\[1\]/, ''));
-    }
-    // Otherwise, if the segment is empty or html or body or ends with a subscript:
-    else if (segment === '' || ['html', 'body'].includes(segment) || segment.endsWith(']')) {
-      // Add it to the array.
-      normalizedSegments.push(segment);
-    }
-    // Otherwise, i.e. if the segment is a tag name with no subscript:
-    else {
-      // Add it with a subscript 1 to the array.
-      normalizedSegments.push(`${segment}[1]`);
-    }
-  });
-  // Return the concatenated segments as the normalized XPath.
-  return normalizedSegments.join('/');
+  if (xPath) {
+    xPath = xPath.replace(/^\.\/\//, '/');
+    const segments = xPath.split('/');
+    // Initialize an array of normalized segments.
+    const normalizedSegments = [];
+    // For each segment of the XPath:
+    segments.forEach(segment => {
+      // If the segment is html[1] or body[1]:
+      if (/html\[1\]|body\[1\]/.test(segment)) {
+        // Add it without its subscript to the array.
+        normalizedSegments.push(segment.replace(/\[1\]/, ''));
+      }
+      // Otherwise, if the segment is empty or html or body or ends with a subscript:
+      else if (segment === '' || ['html', 'body'].includes(segment) || segment.endsWith(']')) {
+        // Add it to the array.
+        normalizedSegments.push(segment);
+      }
+      // Otherwise, i.e. if the segment is a tag name with no subscript:
+      else {
+        // Add it with a subscript 1 to the array.
+        normalizedSegments.push(`${segment}[1]`);
+      }
+    });
+    // Return the concatenated segments as the normalized XPath.
+    return normalizedSegments.join('/');
+  }
+  else {
+    return '';
+  }
 };
 // Adds a box ID and a path ID to an object.
 const addIDs = async (locator, recipient) => {

package/procs/nu.js

@@ -17,7 +17,7 @@
 // Module to add Testaro IDs to elements.
 const {addTestaroIDs} = require('./testaro');
 // Module to get location data from an element.
-const {getLocationData} = require('./getLocatorData');
+const {getElementData} = require('./getLocatorData');
 // Module to get the document source.
 const {getSource} = require('./getSource');
 
@@ -94,7 +94,7 @@ exports.curate = async (page, data, nuData, rules) => {
     for (const message of result.messages) {
       const {extract} = message;
       // Add location data for the element to the message.
-      message.elementLocation = await getLocationData(page, extract);
+      message.elementLocation = await getElementData(page, extract);
     }
   }
   // Return the result.

package/procs/standardize.js

@@ -16,7 +16,6 @@
 // IMPORTS
 
 const {cap} = require('./job');
-const {getNormalizedXPath} = require('./identify');
 
 // FUNCTIONS
 
@@ -41,103 +40,6 @@ const getIdentifiers = exports.getIdentifiers = code => {
   }
   return ['', ''];
 };
-/*
-  Differentiates some rule IDs of aslint.
-  If the purported rule ID is a key and the what property contains all of the strings except the
-  last of any array item of the value of that key, then the final rule ID is the last item of that
-  array item.
-*/
-const aslintData = {
-  'misused_required_attribute': [
-    ['not needed', 'misused_required_attributeR']
-  ],
-  'accessible_svg': [
-    ['associated', 'accessible_svgI'],
-    ['tabindex', 'accessible_svgT']
-  ],
-  'audio_alternative': [
-    ['track', 'audio_alternativeT'],
-    ['alternative', 'audio_alternativeA'],
-    ['bgsound', 'audio_alternativeB']
-  ],
-  'table_missing_description': [
-    ['describedby', 'associated', 'table_missing_descriptionDM'],
-    ['labeledby', 'associated', 'table_missing_descriptionLM'],
-    ['caption', 'not been defined', 'table_missing_descriptionC'],
-    ['summary', 'empty', 'table_missing_descriptionS'],
-    ['describedby', 'empty', 'table_missing_descriptionDE'],
-    ['labeledby', 'empty', 'table_missing_descriptionLE'],
-    ['caption', 'no content', 'table_missing_descriptionE']
-  ],
-  'label_implicitly_associated': [
-    ['only whice spaces', 'label_implicitly_associatedW'],
-    ['more than one', 'label_implicitly_associatedM']
-  ],
-  'label_inappropriate_association': [
-    ['Missing', 'label_inappropriate_associationM'],
-    ['non-form', 'label_inappropriate_associationN']
-  ],
-  'table_row_and_column_headers': [
-    ['headers', 'table_row_and_column_headersRC'],
-    ['Content', 'table_row_and_column_headersB'],
-    ['head of the columns', 'table_row_and_column_headersH']
-  ],
-  'color_contrast_state_pseudo_classes_abstract': [
-    ['position: fixed', 'color_contrast_state_pseudo_classes_abstractF'],
-    ['transparent', 'color_contrast_state_pseudo_classes_abstractB'],
-    ['least 3:1', 'color_contrast_state_pseudo_classes_abstract3'],
-    ['least 4.5:1', 'color_contrast_state_pseudo_classes_abstract4']
-  ],
-  'color_contrast_state_pseudo_classes_active': [
-    ['position: fixed', 'color_contrast_state_pseudo_classes_abstractF'],
-    ['transparent', 'color_contrast_state_pseudo_classes_abstractB'],
-    ['least 3:1', 'color_contrast_state_pseudo_classes_abstract3'],
-    ['least 4.5:1', 'color_contrast_state_pseudo_classes_abstract4']
-  ],
-  'color_contrast_state_pseudo_classes_focus': [
-    ['position: fixed', 'color_contrast_state_pseudo_classes_abstractF'],
-    ['transparent', 'color_contrast_state_pseudo_classes_abstractB'],
-    ['least 3:1', 'color_contrast_state_pseudo_classes_abstract3'],
-    ['least 4.5:1', 'color_contrast_state_pseudo_classes_abstract4']
-  ],
-  'color_contrast_state_pseudo_classes_hover': [
-    ['position: fixed', 'color_contrast_state_pseudo_classes_abstractF'],
-    ['transparent', 'color_contrast_state_pseudo_classes_abstractB'],
-    ['least 3:1', 'color_contrast_state_pseudo_classes_abstract3'],
-    ['least 4.5:1', 'color_contrast_state_pseudo_classes_abstract4']
-  ],
-  'color_contrast_aaa': [
-    ['transparent', 'color_contrast_aaaB'],
-    ['least 4.5:1', 'color_contrast_aaa4'],
-    ['least 7:1', 'color_contrast_aaa7']
-  ],
-  'animation': [
-    ['duration', 'animationD'],
-    ['iteration', 'animationI'],
-    ['mechanism', 'animationM']
-  ],
-  'page_title': [
-    ['empty', 'page_titleN'],
-    ['not identify', 'page_titleU']
-  ],
-  'aria_labelledby_association': [
-    ['exist', 'aria_labelledby_associationN'],
-    ['empty', 'aria_labelledby_associationE']
-  ],
-  'html_lang_attr': [
-    ['parameters', 'html_lang_attrP'],
-    ['nothing', 'html_lang_attrN'],
-    ['empty', 'html_lang_attrE']
-  ],
-  'missing_label': [
-    ['associated', 'missing_labelI'],
-    ['defined', 'missing_labelN'],
-    ['multiple labels', 'missing_labelM']
-  ],
-  'orientation': [
-    ['loaded', 'orientationT']
-  ]
-};
 // Converts issue instances at an axe certainty level.
 const doAxe = (result, standardResult, certainty) => {
   if (result.details && result.details[certainty]) {
@@ -379,95 +281,14 @@ const convert = (toolName, data, result, standardResult) => {
     // Add that to the standard result and disregard tool-specific conversions.
     standardResult.prevented = true;
   }
-  // alfa
-  else if (toolName === 'alfa' && result.standardResult) {
+  // alfa, aslint
+  else if (['alfa', 'aslint'].includes(toolName) && result.standardResult) {
     // Move the results to standard locations.
     Object.assign(result, result.nativeResult);
     Object.assign(standardResult, result.standardResult);
     delete result.nativeResult;
     delete result.standardResult;
   }
-  // aslint
-  else if (toolName === 'aslint' && result.summary && result.summary.byIssueType) {
-    // For each rule:
-    Object.keys(result.rules).forEach(ruleID => {
-      // If it has a valid issue type:
-      const {issueType} = result.rules[ruleID];
-      if (issueType && ['warning', 'error'].includes(issueType)) {
-        // If there are any violations:
-        const ruleResults = result.rules[ruleID].results;
-        if (ruleResults && ruleResults.length) {
-          // For each violation:
-          ruleResults.forEach(ruleResult => {
-            // If it has a description:
-            if (
-              ruleResult.message
-              && ruleResult.message.actual
-              && ruleResult.message.actual.description
-            ) {
-              const what = ruleResult.message.actual.description;
-              // Get the differentiated ID of the rule if any.
-              const ruleData = aslintData[ruleID];
-              let finalRuleID = ruleID;
-              if (ruleData) {
-                const changer = ruleData.find(
-                  specs => specs.slice(0, -1).every(matcher => what.includes(matcher))
-                );
-                if (changer) {
-                  finalRuleID = changer[changer.length - 1];
-                }
-              }
-              // Initialize the path ID of the violating element as any normalized reported XPath.
-              let pathID = getNormalizedXPath(ruleResult.element && ruleResult.element.xpath) || '';
-              const {locationData} = ruleResult;
-              // If an XPath was obtained from the excerpt:
-              if (locationData && locationData.pathID) {
-                // Replace the path ID with it, because some ASLint-reported XPaths are abbreviated.
-                ({pathID} = locationData);
-              }
-              // Get and normalize the reported excerpt.
-              const excerpt = ruleResult.element
-              && ruleResult.element.html
-              && ruleResult.element.html.replace(/\s+/g, ' ')
-              || '';
-              // Get the tag name from the XPath, if possible.
-              let tagName = pathID && pathID.replace(/[^-\w].*$/, '').toUpperCase() || '';
-              if (! tagName && finalRuleID.endsWith('_svg')) {
-                tagName = 'SVG';
-              }
-              // If that was impossible but there is a tag name in the excerpt:
-              if (! tagName && /^<[a-z]+[ >]/.test(excerpt)) {
-                // Get it.
-                tagName = excerpt.slice(1).replace(/[ >].+/, '').toUpperCase();
-              }
-              // Get the ID, if any.
-              const idDraft = excerpt && excerpt.replace(/^[^[>]+id="/, 'id=').replace(/".*$/, '');
-              const idFinal = idDraft && idDraft.length > 3 && idDraft.startsWith('id=')
-                ? idDraft.slice(3)
-                : '';
-              const id = idFinal === '' || isBadID(idFinal) ? '' : idFinal;
-              const instance = {
-                ruleID: finalRuleID,
-                what,
-                ordinalSeverity: ['warning', 0, 0, 'error'].indexOf(issueType),
-                tagName,
-                id,
-                location: {
-                  doc: 'dom',
-                  type: 'xpath',
-                  spec: pathID
-                },
-                excerpt,
-                boxID: '',
-                pathID
-              };
-              standardResult.instances.push(instance);
-            }
-          });
-        }
-      }
-    });
-  }
   // axe
   else if (
     toolName === 'axe'

package/run.js

@@ -1871,8 +1871,8 @@ const doActs = async (report, opts = {}) => {
             // Increment the path ID count.
             actIDData.pathIDCount++;
           }
-          // If the instance has a text:
-          if (text) {
+          // If the instance has any text segments:
+          if (text?.[0]?.length) {
             // Increment the text count.
             actIDData.textCount++;
           }

package/testaro/motion.js

@@ -19,7 +19,7 @@ const fs = require('fs/promises');
 // Module to get operating-system properties.
 const os = require('os');
 // Module to compare screenshots.
-const pixelmatch = require('pixelmatch').default;
+const blazediff = require('@blazediff/core').diff;
 // Module to parse PNGs.
 const {PNG} = require('pngjs');
 
@@ -60,7 +60,7 @@ exports.reporter = async page => {
       // Otherwise, i.e. if their dimensions are identical:
       else {
         // Get the count of differing pixels between the shots.
-        const pixelChanges = pixelmatch(shoot0PNG.data, shoot1PNG.data, null, width, height);
+        const pixelChanges = blazediff(shoot0PNG.data, shoot1PNG.data, null, width, height);
         // Get the ratio of differing to all pixels as a percentage.
         const changePercent = Math.round(100 * pixelChanges / (width * height));
         // Free the memory used by screenshots.

package/tests/alfa.js

@@ -121,9 +121,18 @@ exports.reporter = async (page, report, actIndex) => {
               }
             }
             catch(error) {}
-            let text = '';
+            const text = [];
             try {
-              text = await targetLoc.innerText({timeout: 50});
+              const textRaw = await targetLoc.innerText({timeout: 50});
+              const segments = textRaw?.trim().split(/[\t\n]+/).filter(segment => segment.length);
+              if (segments?.length) {
+                if (segments.length > 1) {
+                  text.push(segments[0], segments[segments.length - 1]);
+                }
+                else {
+                  text.push(segments[0]);
+                }
+              }
             }
             catch(error) {}
             // Get rule-specific properties of a standard instance.

package/tests/aslint.js

@@ -17,20 +17,138 @@
 
 // Function to add unique identifiers to the elements in the page.
 const {addTestaroIDs} = require('../procs/testaro');
+// Module to simplify strings.
+const {cap, tidy} = require('../procs/job');
 // Module to handle files.
 const fs = require('fs/promises');
-// Function to get location data from an element.
-const {getLocationData} = require('../procs/getLocatorData');
+// Function to get location data with a Testaro identifier.
+const {getElementData} = require('../procs/getLocatorData');
+// Function to normalize an XPath.
+const {getNormalizedXPath} = require('../procs/identify');
+
+// CONSTANTS
+
+/*
+  Differentiates some rule IDs of aslint.
+  If the purported rule ID is a key and the what property contains all of the strings except the
+  last of any array item of the value of that key, then the final rule ID is the last item of that
+  array item.
+*/
+const aslintData = {
+  'misused_required_attribute': [
+    ['not needed', 'misused_required_attributeR']
+  ],
+  'accessible_svg': [
+    ['associated', 'accessible_svgI'],
+    ['tabindex', 'accessible_svgT']
+  ],
+  'audio_alternative': [
+    ['track', 'audio_alternativeT'],
+    ['alternative', 'audio_alternativeA'],
+    ['bgsound', 'audio_alternativeB']
+  ],
+  'table_missing_description': [
+    ['describedby', 'associated', 'table_missing_descriptionDM'],
+    ['labeledby', 'associated', 'table_missing_descriptionLM'],
+    ['caption', 'not been defined', 'table_missing_descriptionC'],
+    ['summary', 'empty', 'table_missing_descriptionS'],
+    ['describedby', 'empty', 'table_missing_descriptionDE'],
+    ['labeledby', 'empty', 'table_missing_descriptionLE'],
+    ['caption', 'no content', 'table_missing_descriptionE']
+  ],
+  'label_implicitly_associated': [
+    ['only whice spaces', 'label_implicitly_associatedW'],
+    ['more than one', 'label_implicitly_associatedM']
+  ],
+  'label_inappropriate_association': [
+    ['Missing', 'label_inappropriate_associationM'],
+    ['non-form', 'label_inappropriate_associationN']
+  ],
+  'table_row_and_column_headers': [
+    ['headers', 'table_row_and_column_headersRC'],
+    ['Content', 'table_row_and_column_headersB'],
+    ['head of the columns', 'table_row_and_column_headersH']
+  ],
+  'color_contrast_state_pseudo_classes_abstract': [
+    ['position: fixed', 'color_contrast_state_pseudo_classes_abstractF'],
+    ['transparent', 'color_contrast_state_pseudo_classes_abstractB'],
+    ['least 3:1', 'color_contrast_state_pseudo_classes_abstract3'],
+    ['least 4.5:1', 'color_contrast_state_pseudo_classes_abstract4']
+  ],
+  'color_contrast_state_pseudo_classes_active': [
+    ['position: fixed', 'color_contrast_state_pseudo_classes_abstractF'],
+    ['transparent', 'color_contrast_state_pseudo_classes_abstractB'],
+    ['least 3:1', 'color_contrast_state_pseudo_classes_abstract3'],
+    ['least 4.5:1', 'color_contrast_state_pseudo_classes_abstract4']
+  ],
+  'color_contrast_state_pseudo_classes_focus': [
+    ['position: fixed', 'color_contrast_state_pseudo_classes_abstractF'],
+    ['transparent', 'color_contrast_state_pseudo_classes_abstractB'],
+    ['least 3:1', 'color_contrast_state_pseudo_classes_abstract3'],
+    ['least 4.5:1', 'color_contrast_state_pseudo_classes_abstract4']
+  ],
+  'color_contrast_state_pseudo_classes_hover': [
+    ['position: fixed', 'color_contrast_state_pseudo_classes_abstractF'],
+    ['transparent', 'color_contrast_state_pseudo_classes_abstractB'],
+    ['least 3:1', 'color_contrast_state_pseudo_classes_abstract3'],
+    ['least 4.5:1', 'color_contrast_state_pseudo_classes_abstract4']
+  ],
+  'color_contrast_aaa': [
+    ['transparent', 'color_contrast_aaaB'],
+    ['least 4.5:1', 'color_contrast_aaa4'],
+    ['least 7:1', 'color_contrast_aaa7']
+  ],
+  'animation': [
+    ['duration', 'animationD'],
+    ['iteration', 'animationI'],
+    ['mechanism', 'animationM']
+  ],
+  'page_title': [
+    ['empty', 'page_titleN'],
+    ['not identify', 'page_titleU']
+  ],
+  'aria_labelledby_association': [
+    ['exist', 'aria_labelledby_associationN'],
+    ['empty', 'aria_labelledby_associationE']
+  ],
+  'html_lang_attr': [
+    ['parameters', 'html_lang_attrP'],
+    ['nothing', 'html_lang_attrN'],
+    ['empty', 'html_lang_attrE']
+  ],
+  'missing_label': [
+    ['associated', 'missing_labelI'],
+    ['defined', 'missing_labelN'],
+    ['multiple labels', 'missing_labelM']
+  ],
+  'orientation': [
+    ['loaded', 'orientationT']
+  ]
+};
 
 // FUNCTIONS
 
 // Conducts and reports the ASLint tests.
-exports.reporter = async (page, report, actIndex, timeLimit) => {
-  // Add unique identifiers to the elements in the page.
+exports.reporter = async (page, report, actIndex) => {
+  // Add unique Testaro identifiers to the elements in the page.
   await addTestaroIDs(page);
   // Initialize the act report.
   let data = {};
-  let result = {};
+  const result = {
+    nativeResult: {},
+    standardResult: {}
+  };
+  const standard = report.standard !== 'no';
+  // If standard results are to be reported:
+  if (standard) {
+    // Initialize the standard result.
+    result.standardResult = {
+      prevented: false,
+      totals: [0, 0, 0, 0],
+      instances: []
+    };
+  }
+  const {standardResult} = result;
   // Get the ASLint runner and bundle scripts.
   const aslintRunner = await fs.readFile(`${__dirname}/../procs/aslint.js`, 'utf8');
   const aslintBundlePath = require.resolve('aslint-testaro/aslint.bundle.js');
@@ -65,6 +183,9 @@ exports.reporter = async (page, report, actIndex, timeLimit) => {
     console.log(message);
     data.prevented = true;
     data.error = message;
+    if (standard) {
+      standardResult.prevented = true;
+    }
   });
   const reportLoc = page.locator('#aslintResult');
   // If the injection succeeded:
@@ -73,7 +194,7 @@ exports.reporter = async (page, report, actIndex, timeLimit) => {
       // Wait for the test results to be attached to the page.
       const waitOptions = {
         state: 'attached',
-        timeout: 1000 * timeLimit
+        timeout: 20000
       };
       await reportLoc.waitFor(waitOptions);
     }
@@ -88,47 +209,102 @@ exports.reporter = async (page, report, actIndex, timeLimit) => {
   if (! data.prevented) {
     // Get their text.
     const actReport = await reportLoc.textContent();
-    result = JSON.parse(actReport);
-    // If any rules were reported violated:
-    if (result.rules) {
-      // For each such rule:
-      for (const ruleID of Object.keys(result.rules)) {
-        const excluded = act.rules && ! act.rules.includes(ruleID);
-        const instanceType = result.rules[ruleID].status.type;
-        // If rules to be tested were specified and exclude it or the rule was passed or skipped:
-        if (excluded || ['passed', 'skipped'].includes(instanceType)) {
-          // Delete the rule report.
-          delete result.rules[ruleID];
+    try {
+      const nativeResult = result.nativeResult = JSON.parse(actReport);
+      // If any rules were reported violated:
+      if (nativeResult.rules) {
+        const {rules} = nativeResult;
+        // For each such rule:
+        for (const ruleID of Object.keys(rules)) {
+          const ruleData = rules[ruleID];
+          const {issueType, status} = ruleData;
+          const excluded = act.rules && ! act.rules.includes(ruleID);
+          const {type} = status;
+          // If rule is not an error or warning or is not to be tested:
+          if (
+            excluded
+            || ['passed', 'skipped'].includes(type)
+            || ! ['error', 'warning'].includes(issueType)
+          ) {
+            // Delete the rule report.
+            delete rules[ruleID];
+          }
         }
-        // Otherwise, i.e. if the rule was violated:
-        else {
-          const ruleResults = result.rules[ruleID].results;
-          // For each violation:
-          for (const ruleResult of ruleResults) {
-            const excerpt = ruleResult.element
-            && ruleResult.element.html.replace(/\s+/g, ' ')
-            || '';
-            // If an element excerpt was reported:
-            if (excerpt) {
-              // Use it to add location data to the violation data in the result.
-              ruleResult.locationData = await getLocationData(page, excerpt);
+        // If standard results are to be reported:
+        if (standard) {
+          const ruleIDs = Object.keys(rules);
+          // For each violated rule:
+          for (let ruleID of ruleIDs) {
+            const ruleData = rules[ruleID];
+            const {issueType, results} = ruleData;
+            // For each violation:
+            for (const result of results) {
+              const {message, element} = result;
+              const what = message?.actual?.description ?? '';
+              // Get the values of the properties required for a standard result.
+              if (ruleID) {
+                const changer = aslintData[ruleID]?.find(
+                  specs => specs.slice(0, -1).every(matcher => what.includes(matcher))
+                );
+                if (changer) {
+                  ruleID = changer[changer.length - 1];
+                }
+              }
+              const ordinalSeverity = issueType === 'warning' ? 1 : 2;
+              const {html, xpath} = element;
+              const excerpt = html?.replace(/\s+/g, ' ') ?? '';
+              let tagName = '';
+              let id = '';
+              let text = [];
+              let notInDOM = false;
+              let boxID = '';
+              let pathID = '';
+              if (excerpt) {
+                const elementData = await getElementData(page, excerpt);
+                ({tagName, id, text, notInDOM, boxID, pathID, originalExcerpt} = elementData);
+              }
+              if (! pathID) {
+                pathID = getNormalizedXPath(xpath);
+              }
+              if (pathID && ! tagName) {
+                tagName = pathID?.replace(/[^-\w].*$/, '').toUpperCase() ?? '';
+              }
+              if (ruleID.endsWith('_svg') && ! tagName) {
+                tagName = 'SVG';
+              }
+              // Add an instance to the standard result.
+              standardResult.instances.push({
+                ruleID,
+                what,
+                ordinalSeverity,
+                count: 1,
+                tagName,
+                id,
+                location: {
+                  notInDOM,
+                  doc: 'dom',
+                  type: 'xpath',
+                  spec: pathID
+                },
+                excerpt: cap(tidy(originalExcerpt)),
+                text,
+                boxID,
+                pathID
+              });
             }
-          };
+          }
         }
-      };
+      }
+    }
+    // If the results are not JSON:
+    catch(error) {
+      const message = `Result processing failed (${error.message})`;
+      console.log(`ERROR: ${message}`);
+      // Report this.
+      data.prevented = true;
+      data.error = message;
     }
   }
-  // Return the act report.
-  try {
-    JSON.stringify(data);
-  }
-  catch(error) {
-    const message = `ERROR: ASLint result cannot be made JSON (${error.message.slice(0, 200)})`;
-    data = {
-      prevented: true,
-      error: message
-    };
-  };
   return {
     data,
     result

package/tests/htmlcs.js

@@ -18,7 +18,7 @@
 // Module to add and use unique element IDs.
 const {addTestaroIDs} = require('../procs/testaro');
 // Module to get location data from an element.
-const {getLocationData} = require('../procs/getLocatorData');
+const {getElementData} = require('../procs/getLocatorData');
 // Module to handle files.
 const fs = require('fs/promises');
 
@@ -102,7 +102,7 @@ exports.reporter = async (page, report, actIndex) => {
         const ruleID = parts[1].replace(/^WCAG2|\.Principle\d\.Guideline[\d_]+/g, '');
         result[parts[0]][ruleID] ??= {};
         result[parts[0]][ruleID][parts[4]] ??= [];
-        const elementLocation = await getLocationData(page, parts[5]);
+        const elementLocation = await getElementData(page, parts[5]);
         const {boxID, notInDOM, pathID} = elementLocation;
         result[parts[0]][ruleID][parts[4]].push({
           tagName: parts[2],

package/tests/qualWeb.js

@@ -20,7 +20,7 @@ const {ACTRules} = require('@qualweb/act-rules');
 const {WCAGTechniques} = require('@qualweb/wcag-techniques');
 const {BestPractices} = require('@qualweb/best-practices');
 const {addTestaroIDs} = require('../procs/testaro');
-const {getLocationData} = require('../procs/getLocatorData');
+const {getElementData} = require('../procs/getLocatorData');
 
 // CONSTANTS
 
@@ -211,7 +211,7 @@ exports.reporter = async (page, report, actIndex, timeLimit) => {
                       // For each violating element:
                       for (const element of elements) {
                         // Add location data from its excerpt to the element data.
-                        element.locationData = await getLocationData(page, element.htmlCode);
+                        element.locationData = await getElementData(page, element.htmlCode);
                         // Limit the size of its reported excerpt.
                         if (element.htmlCode && element.htmlCode.length > 700) {
                           element.htmlCode = `${element.htmlCode.slice(0, 700)} …`;

package/tests/wax.js

@@ -18,7 +18,7 @@
 // Function to add and use unique element IDs.
 const {addTestaroIDs} = require('../procs/testaro');
 // Function to get location data from an element.
-const {getLocationData} = require('../procs/getLocatorData');
+const {getElementData} = require('../procs/getLocatorData');
 // Modules to run WAX.
 const runWax = require('@wally-ax/wax-dev');
 const waxDev = {runWax};
@@ -63,7 +63,7 @@ exports.reporter = async (page, report, actIndex) => {
         // Add location data to its reported violations.
         for (const violation of actReport) {
           const {element} = violation;
-          const elementLocation = await getLocationData(page, element);
+          const elementLocation = await getElementData(page, element);
           Object.assign(violation, elementLocation);
         }
         // Populate the act report.