testaro 74.2.3 → 75.1.0

package/procs/shoot.js

@@ -6,57 +6,35 @@
 
 /*
   shoot
-  Makes and saves as a PNG buffer file a full-page screenshot and returns the file path.
-
-  Call shape:
-    shoot(page, label, options?)
-      label:   string|number used in the saved filename. Sanitized to
-               testaro-shoot-<safe>.png — characters outside [A-Za-z0-9._-]
-               collapse to '_', leading/trailing dots and underscores are
-               stripped, length is capped at 100, and an empty result becomes
-               'unnamed'.
-      options: optional object:
-        exclusion: a Playwright Locator to mask in the screenshot.
-        dir:       output directory (defaults to the OS temp dir).
+  Manages the production and disposition of screenshots of a page.
 */
 
 // IMPORTS
 
 // Shared configuration for timeout multiplier.
 const {applyMultiplier} = require('./config');
+const {nowStamp} = require('./dateTime');
 const fs = require('fs/promises');
 const path = require('path');
 const {PNG} = require('pngjs');
 
 // FUNCTIONS
 
-/*
-  Coerces a label into a filesystem-safe string. Runs of any character outside
-  [A-Za-z0-9._-] collapse to one underscore; leading and trailing dots and
-  underscores are stripped (no hidden files, no traversal); capped at 100
-  characters; falls back to 'unnamed' if nothing usable remains.
-*/
-const sanitizeLabel = (label) => {
-  const raw = String(label);
-  const cleaned = raw
-    .replace(/[^A-Za-z0-9._-]+/g, '_')
-    .replace(/^[._]+|[._]+$/g, '')
-    .slice(0, 100) || 'unnamed';
-  if (cleaned !== raw) {
-    console.log(`>> shoot: label sanitized from "${raw}" to "${cleaned}"`);
-  }
-  return cleaned;
+// Returns a probably unique file name.
+const randomFileName = (suffixLength = 3) => {
+  const fileName = `${nowStamp()}-${Math.random().toString(36).slice(2, 2 + suffixLength)}`;
+  return fileName;
 };
-
 // Creates and returns a screenshot.
-const screenShot = async (page, exclusion = null) => {
+const screenShot = async (page, exclusionLocator = null) => {
   const options = {
     fullPage: true,
     omitBackground: true,
+    scale: 'css',
     timeout: applyMultiplier(4000)
   };
-  if (exclusion) {
-    options.mask = [exclusion];
+  if (exclusionLocator) {
+    options.mask = [exclusionLocator];
   }
   // Make and return a screenshot as a buffer.
   return await page.screenshot(options)
@@ -65,28 +43,55 @@ const screenShot = async (page, exclusion = null) => {
     return '';
   });
 };
-exports.shoot = async (page, label, tmpDir, options = {}) => {
-  const exclusion = options.exclusion || null;
-  const dir = options.dir || tmpDir;
+// Creates and disposes of the PNG of a screenshot.
+exports.shoot = async (page, report, {
+  // Playwright locator of a mask.
+  exclusionSelector = null,
+  // Color fidelity: 0 (grayscale), 2 (RGB), 4 (grayscale alpha), 6 (RGBA).
+  colorType = 0,
+  // Disposition: return, report, file.
+  action = 'return'
+} = {}) => {
   // Make and get a screenshot as a buffer.
-  let shot = await screenShot(page, exclusion);
+  let shot = await screenShot(page, exclusionSelector ? page.locator(exclusionSelector) : null);
   // If it succeeded:
   if (shot.length) {
     // Get the screenshot as an object representation of a PNG image.
     let png = PNG.sync.read(shot);
     shot = null;
-    const pngBuffer = PNG.sync.write(png);
+    // Convert the PNG object to a buffer, applying the specified color type.
+    const pngBuffer = PNG.sync.write(png, {colorType});
     png = null;
     // Force garbage collection if available and if --expose-gc was a node option.
     if (global.gc) {
       global.gc();
     }
-    const fileName = `testaro-shoot-${sanitizeLabel(label)}.png`;
-    const pngPath = path.join(dir, fileName);
-    // Save the PNG buffer.
-    await fs.writeFile(pngPath, pngBuffer);
-    // Return the result.
-    return pngPath;
+    // Convert the buffer to a base64 string.
+    const base64 = pngBuffer.toString('base64');
+    // If the string is to be returned:
+    if (action === 'return') {
+      // Return it.
+      return base64;
+    }
+    // Otherwise, if it is to be appended to the report:
+    if (action === 'report') {
+      report.images ??= [];
+      // Append it to the images array in the report.
+      report.images.push(base64);
+      // Return the index of the added image in the array.
+      return report.images.length - 1;
+    }
+    // Otherwise, if it is to be saved in a file:
+    if (action === 'file') {
+      const fileName = randomFileName(4);
+      const filePath = path.join(report.jobData.tmpDir, fileName);
+      // Save it in a file.
+      await fs.writeFile(filePath, base64);
+      // Return the file name.
+      return fileName;
+    }
+    // Otherwise, i.e. if the action is invalid, return this.
+    return '';
   }
   // Otherwise, i.e. if it failed:
   else {

package/run.js

@@ -126,7 +126,9 @@ exports.doJob = async (job, opts = {}) => {
     });
     // If the job specifies a browser ID and a target and requires standardization:
     if (job.browserID && job.target && job.standard !== 'no') {
-      // Create a catalog of the target and add it to the report.
+      // Initialize a catalog so it precedes any page images in the report.
+      report.catalog = {};
+      // Add a catalog of the target, and a page image if required, to the report.
       report.catalog = await getCatalog(report);
     }
     // Perform the acts and revise the report.

package/testaro/adbID.js

@@ -22,7 +22,7 @@ const {doTest} = require('../procs/testaro');
 // FUNCTIONS
 
 // Runs the test and returns the result.
-exports.reporter = async (page, catalog, withItems) => {
+exports.reporter = async (page, report, _, withItems) => {
   const getBadWhat = element => {
     // Get the IDs in the aria-describedby attribute of the element.
     const IDs = element.getAttribute('aria-describedby').trim().split(/\s+/).filter(Boolean);
@@ -57,6 +57,6 @@ exports.reporter = async (page, catalog, withItems) => {
   };
   const whats = 'Elements have aria-describedby attributes with missing or invalid id values';
   return await doTest(
-    page, catalog, withItems, 'adbID', 'body [aria-describedby]', whats, 3, getBadWhat.toString()
+    page, report.catalog, withItems, 'adbID', 'body [aria-describedby]', whats, 3, getBadWhat.toString()
   );
 };

package/testaro/allCapStyle.js

@@ -20,7 +20,7 @@ const {doTest} = require('../procs/testaro');
 // FUNCTIONS
 
 // Runs the test and returns the result.
-exports.reporter = async (page, catalog, withItems) => {
+exports.reporter = async (page, report, _, withItems) => {
   const getBadWhat = element => {
     // Get the style declaration of the element.
     const styleDec = window.getComputedStyle(element);
@@ -46,6 +46,6 @@ exports.reporter = async (page, catalog, withItems) => {
   const selector = 'body, body *:not(style, script, svg)';
   const whats = 'Elements have an all-capital text transformation style';
   return await doTest(
-    page, catalog, withItems, 'allCapStyle', selector, whats, 0, getBadWhat.toString()
+    page, report.catalog, withItems, 'allCapStyle', selector, whats, 0, getBadWhat.toString()
   );
 };

package/testaro/allCaps.js

@@ -110,12 +110,12 @@ const classifyWithAI = entries => new Promise((resolve, reject) => {
 });
 
 // Runs the test and returns the result.
-exports.reporter = async (_, catalog, withItems) => {
+exports.reporter = async (_0, report, _1, withItems) => {
   const data = {};
   const totals = [0, 0, 0, 0];
   const standardInstances = [];
   // Get data on the catalog entries whose text values contain 2+ consecutive capital letters.
-  const qualifying = Object.entries(catalog)
+  const qualifying = Object.entries(report.catalog)
   .filter(([, entry]) => entry.text && /\p{Lu}{2,}/u.test(entry.text))
   .map(([index, entry]) => ({
     index: Number(index),
@@ -163,7 +163,7 @@ exports.reporter = async (_, catalog, withItems) => {
   }
   catch(error) {
     data.aiError = error.message;
-    violations = getRuleBasedViolations(catalog);
+    violations = getRuleBasedViolations(report.catalog);
   }
   const estimatedLeftOut = data.leftOut?.estimatedViolations ?? 0;
   // Add the estimated violation count to the totals.

package/testaro/allHidden.js

@@ -19,7 +19,7 @@ const {getXPathCatalogIndex} = require('../procs/xPath');
 // FUNCTIONS
 
 // Runs the test and returns the result.
-exports.reporter = async (page, catalog) => {
+exports.reporter = async (page, report) => {
   // Get a count of elements deemed visible by Playwright.
   const visibleElementCount = await page.locator('body :visible').count();
   // If no element is visible:
@@ -33,7 +33,7 @@ exports.reporter = async (page, catalog) => {
         what: 'The entire page body is hidden or empty',
         ordinalSeverity: 3,
         count: 1,
-        catalogIndex: getXPathCatalogIndex(catalog, '/html/body')
+        catalogIndex: getXPathCatalogIndex(report.catalog, '/html/body')
       }]
     };
   }

package/testaro/allSlanted.js

@@ -20,7 +20,7 @@ const {doTest} = require('../procs/testaro');
 // FUNCTIONS
 
 // Runs the test and returns the result.
-exports.reporter = async (page, catalog, withItems) => {
+exports.reporter = async (page, report, _, withItems) => {
   const getBadWhat = element => {
     const styleDec = window.getComputedStyle(element);
     const {textContent} = element;
@@ -45,6 +45,6 @@ exports.reporter = async (page, catalog, withItems) => {
   const selector = 'body, body *:not(style, script, svg)';
   const whats = 'Elements contain all-slanted text';
   return await doTest(
-    page, catalog, withItems, 'allSlanted', selector, whats, 0, getBadWhat.toString()
+    page, report.catalog, withItems, 'allSlanted', selector, whats, 0, getBadWhat.toString()
   );
 };

package/testaro/altScheme.js

@@ -21,7 +21,7 @@ const {doTest} = require('../procs/testaro');
 // FUNCTIONS
 
 // Runs the test and returns the result.
-exports.reporter = async (page, catalog, withItems) => {
+exports.reporter = async (page, report, _, withItems) => {
   const getBadWhat = element => {
     // Get the value of the alt attribute of the element.
     const alt = (element.getAttribute('alt') || '').trim();
@@ -41,6 +41,6 @@ exports.reporter = async (page, catalog, withItems) => {
   };
   const whats = 'img elements have alt attributes with URL or filename values';
   return await doTest(
-    page, catalog, withItems, 'altScheme', 'body img[alt]', whats, 1, getBadWhat.toString()
+    page, report.catalog, withItems, 'altScheme', 'body img[alt]', whats, 1, getBadWhat.toString()
   );
 };

package/testaro/attVal.js

@@ -19,7 +19,7 @@ const {doTest} = require('../procs/testaro');
 // FUNCTIONS
 
 // Runs the test and returns the result.
-exports.reporter = async (page, catalog, withItems, attributeName, areLicit, values) => {
+exports.reporter = async (page, report, _0, withItems, attributeName, areLicit, values) => {
   const getBadWhat = element => {
     // Get the value of the attribute.
     const value = element.getAttribute(attributeName);
@@ -31,6 +31,6 @@ exports.reporter = async (page, catalog, withItems, attributeName, areLicit, val
   };
   const whats = `Elements have attribute ${attributeName} with illicit values`;
   return await doTest(
-    page, catalog, withItems, 'attVal', `body [${attributeName}]`, whats, 2, getBadWhat.toString()
+    page, report.catalog, withItems, 'attVal', `body [${attributeName}]`, whats, 2, getBadWhat.toString()
   );
 };

package/testaro/autocomplete.js

@@ -22,7 +22,8 @@ const {doTest} = require('../procs/testaro');
 // Runs the test and returns the result.
 exports.reporter = async (
   page,
-  catalog,
+  report,
+  _0,
   withItems,
   labels = {
     name: ['your name', 'full name', 'first and last name'],
@@ -85,5 +86,5 @@ exports.reporter = async (
   [0, 1, 2, 3].forEach(index => {
     getBadWhatString = getBadWhatString.replace(placeHolders[index], replacers[index]);
   });
-  return doTest(page, catalog, withItems, 'autocomplete', selector, whats, 2, getBadWhatString);
+  return doTest(page, report.catalog, withItems, 'autocomplete', selector, whats, 2, getBadWhatString);
 };

package/testaro/bulk.js

@@ -20,7 +20,7 @@ const {getXPathCatalogIndex} = require('../procs/xPath');
 // FUNCTIONS
 
 // Runs the test and returns the result.
-exports.reporter = async (page, catalog) => {
+exports.reporter = async (page, report) => {
   // Get a count of elements deemed visible by Playwright.
   const visibleElementCount = await page.locator('body :visible').count();
   // Convert the count to a severity level, treating up to 400 as non-reportable.
@@ -38,7 +38,7 @@ exports.reporter = async (page, catalog) => {
         what: `Page contains ${visibleElementCount} visible elements`,
         ordinalSeverity: severity,
         count: 1,
-        catalogIndex: getXPathCatalogIndex(catalog, '/html')
+        catalogIndex: getXPathCatalogIndex(report.catalog, '/html')
       }]
     };
   }

package/testaro/buttonMenu.js

@@ -180,7 +180,7 @@ const focusSuccess = async (miLocsDir, priorIndex, key, isPseudo) => {
   return result;
 };
 // Performs the test and reports the result.
-exports.reporter = async (page, catalog, withItems, trialKeySpecs = []) => {
+exports.reporter = async (page, report, _0, withItems, trialKeySpecs = []) => {
   // Initialize the result.
   const data = {};
   const totals = [0, 0, 0, 0];
@@ -304,7 +304,7 @@ exports.reporter = async (page, catalog, withItems, trialKeySpecs = []) => {
                     what: `Menu responds nonstandardly to the ${key} key`,
                     ordinalSeverity: 2,
                     count: 1,
-                    catalogIndex: getXPathCatalogIndex(catalog, mbXPath)
+                    catalogIndex: getXPathCatalogIndex(report.catalog, mbXPath)
                   });
                 }
                 // Stop testing the menu button.
@@ -339,7 +339,7 @@ exports.reporter = async (page, catalog, withItems, trialKeySpecs = []) => {
           what: 'Menu button does not control exactly 1 menu',
           ordinalSeverity: 2,
           count: 1,
-          catalogIndex: getXPathCatalogIndex(catalog, mbXPath)
+          catalogIndex: getXPathCatalogIndex(report.catalog, mbXPath)
         });
       }
     }

package/testaro/captionLoc.js

@@ -20,7 +20,7 @@ const {doTest} = require('../procs/testaro');
 
 // FUNCTIONS
 
-exports.reporter = async (page, catalog, withItems) => {
+exports.reporter = async (page, report, _, withItems) => {
   const getBadWhat = element => {
     const parent = element.parentElement;
     // If the element is not the first child of a table element:
@@ -31,6 +31,6 @@ exports.reporter = async (page, catalog, withItems) => {
   };
   const whats = 'caption elements are not the first children of table elements';
   return await doTest(
-    page, catalog, withItems, 'captionLoc', 'body caption', whats, 3, getBadWhat.toString()
+    page, report.catalog, withItems, 'captionLoc', 'body caption', whats, 3, getBadWhat.toString()
   );
 };

package/testaro/datalistRef.js

@@ -19,7 +19,7 @@ const {doTest} = require('../procs/testaro');
 
 // FUNCTIONS
 
-exports.reporter = async (page, catalog, withItems) => {
+exports.reporter = async (page, report, _, withItems) => {
   const getBadWhat = element => {
     // Get the ID of the datalist element referenced by the list attribute of the element.
     const listID = element.getAttribute('list');
@@ -46,6 +46,6 @@ exports.reporter = async (page, catalog, withItems) => {
   };
   const whats = 'list attributes of input elements are empty or IDs of no or non-datalist elements';
   return await doTest(
-    page, catalog, withItems, 'datalistRef', 'body input[list]', whats, 3, getBadWhat.toString()
+    page, report.catalog, withItems, 'datalistRef', 'body input[list]', whats, 3, getBadWhat.toString()
   );
 };

package/testaro/distortion.js

@@ -21,7 +21,7 @@ const {doTest} = require('../procs/testaro');
 // FUNCTIONS
 
 // Runs the test and returns the result.
-exports.reporter = async (page, catalog, withItems) => {
+exports.reporter = async (page, report, _, withItems) => {
   const getBadWhat = element => {
     const styleDec = window.getComputedStyle(element);
     const {transform} = styleDec;
@@ -38,6 +38,6 @@ exports.reporter = async (page, catalog, withItems) => {
   };
   const whats = 'Elements distort their texts';
   return await doTest(
-    page, catalog, withItems, 'distortion', 'body, body *', whats, 0, getBadWhat.toString()
+    page, report.catalog, withItems, 'distortion', 'body, body *', whats, 0, getBadWhat.toString()
   );
 };

package/testaro/docType.js

@@ -15,7 +15,7 @@
 */
 
 // Runs the test and returns the result.
-exports.reporter = async (page, catalog) => {
+exports.reporter = async (page, report) => {
   // Returns whether the page declares a document type.
   const docHasType = await page.evaluate(() => {
     const docType = document.doctype;

package/testaro/dupAtt.js

@@ -20,7 +20,7 @@ const {getXPathCatalogIndex} = require('../procs/xPath');
 // ########## FUNCTIONS
 
 // Runs the test and returns the result.
-exports.reporter = async (page, catalog, withItems) => {
+exports.reporter = async (page, report, _, withItems) => {
   // Initialize the data and standard result.
   const data = {total: 0};
   if (withItems) {
@@ -96,7 +96,7 @@ exports.reporter = async (page, catalog, withItems) => {
           what: `${item.tagName} element has 2 attributes named ${item.duplicatedAttribute}`,
           ordinalSeverity: 2,
           count: 1,
-          catalogIndex: getXPathCatalogIndex(catalog, '/html/body')
+          catalogIndex: getXPathCatalogIndex(report.catalog, '/html/body')
         });
       });
     }

package/testaro/embAc.js

@@ -20,7 +20,7 @@ const {doTest} = require('../procs/testaro');
 // FUNCTIONS
 
 // Runs the test and returns the result.
-exports.reporter = async (page, catalog, withItems) => {
+exports.reporter = async (page, report, _, withItems) => {
   const getBadWhat = element => {
     // Get whether the embedding element is a link or a button.
     const embedder = element.parentElement.closest('a, button');
@@ -32,5 +32,5 @@ exports.reporter = async (page, catalog, withItems) => {
   .map(tag => `a ${tag}, button ${tag}`)
   .join(', ');
   const whats = 'interactive elements are embedded in links or buttons';
-  return await doTest(page, catalog, withItems, 'embAc', selector, whats, 2, getBadWhat.toString());
+  return await doTest(page, report.catalog, withItems, 'embAc', selector, whats, 2, getBadWhat.toString());
 };

package/testaro/focAll.js

@@ -19,7 +19,7 @@ const {getXPathCatalogIndex} = require('../procs/xPath');
 // FUNCTIONS
 
 // Runs the test and returns the result.
-exports.reporter = async (page, catalog) => {
+exports.reporter = async (page, report) => {
   // Get locators of visible elements.
   const locAll = await page.locator('body *:visible');
   // Get the count of focusable elements.
@@ -74,7 +74,7 @@ exports.reporter = async (page, catalog) => {
       what: 'Some focusable elements are not Tab-focusable or vice versa',
       ordinalSeverity: 2,
       count,
-      catalogIndex: getXPathCatalogIndex(catalog, '/html/body')
+      catalogIndex: getXPathCatalogIndex(report.catalog, '/html/body')
     }] : []
   };
 };

package/testaro/focAndOp.js

@@ -22,7 +22,7 @@ const {doTest} = require('../procs/testaro');
 // FUNCTIONS
 
 // Runs the test and returns the result.
-exports.reporter = async (page, catalog, withItems) => {
+exports.reporter = async (page, report, _, withItems) => {
   const getBadWhat = element => {
     // Get whether the element is visible.
     const isVisible = element.checkVisibility({
@@ -118,6 +118,6 @@ exports.reporter = async (page, catalog, withItems) => {
   };
   const whats = 'Elements are Tab-focusable but not operable or vice versa';
   return await doTest(
-    page, catalog, withItems, 'focAndOp', 'body, body *', whats, 2, getBadWhat.toString()
+    page, report.catalog, withItems, 'focAndOp', 'body, body *', whats, 2, getBadWhat.toString()
   );
 };

package/testaro/focInd.js

@@ -27,7 +27,7 @@ const {doTest} = require('../procs/testaro');
 // FUNCTIONS
 
 // Runs the test and returns the result.
-exports.reporter = async (page, catalog, withItems) => {
+exports.reporter = async (page, report, _, withItems) => {
   const getBadWhat = element => {
     // Get whether the element is visible.
     const isVisible = element.checkVisibility({
@@ -86,6 +86,6 @@ exports.reporter = async (page, catalog, withItems) => {
   };
   const whats = 'Elements fail to have standard focus indicators';
   return await doTest(
-    page, catalog, withItems, 'focInd', 'body, body *', whats, 1, getBadWhat.toString()
+    page, report.catalog, withItems, 'focInd', 'body, body *', whats, 1, getBadWhat.toString()
   );
 };

package/testaro/focVis.js

@@ -21,7 +21,7 @@ const {doTest} = require('../procs/testaro');
 // FUNCTIONS
 
 // Runs the test and returns the result.
-exports.reporter = async (page, catalog, withItems) => {
+exports.reporter = async (page, report, _, withItems) => {
   const getBadWhat = element => {
     const isVisible = element.checkVisibility({
       contentVisibilityAuto: true,
@@ -42,6 +42,6 @@ exports.reporter = async (page, catalog, withItems) => {
   };
   const whats = 'Visible links are above or to the left of the display';
   return await doTest(
-    page, catalog, withItems, 'focVis', 'body a', whats, 2, getBadWhat.toString()
+    page, report.catalog, withItems, 'focVis', 'body a', whats, 2, getBadWhat.toString()
   );
 };

package/testaro/headEl.js

@@ -20,7 +20,7 @@ const {getXPathCatalogIndex} = require('../procs/xPath');
 // ########## FUNCTIONS
 
 // Runs the test and returns the result.
-exports.reporter = async (page, catalog) => {
+exports.reporter = async (page, report) => {
   // Initialize the data and standard result.
   const data = {
     total: 0,
@@ -65,7 +65,7 @@ exports.reporter = async (page, catalog) => {
       what: `Invalid elements within the head: ${data.badTagNames.join(', ')}`,
       ordinalSeverity: 2,
       count: data.total,
-      catalogIndex: getXPathCatalogIndex(catalog, '/html/head')
+      catalogIndex: getXPathCatalogIndex(report.catalog, '/html/head')
     });
   }
   totals = [0, 0, data.total, 0];

package/testaro/headingAmb.js

@@ -20,7 +20,7 @@ const {doTest} = require('../procs/testaro');
 // ########## FUNCTIONS
 
 // Runs the test and returns the result.
-exports.reporter = async (page, catalog, withItems) => {
+exports.reporter = async (page, report, _, withItems) => {
   const getBadWhat = element => {
     const {tagName} = element;
     const level = tagName[1];
@@ -70,6 +70,6 @@ exports.reporter = async (page, catalog, withItems) => {
   const selector = headingLevels.map(level => `body h${level}`).join(', ');
   const whats = 'Adjacent sibling same-level headings have the same text';
   return await doTest(
-    page, catalog, withItems, 'headingAmb', selector, whats, 1, getBadWhat.toString()
+    page, report.catalog, withItems, 'headingAmb', selector, whats, 1, getBadWhat.toString()
   );
 };

package/testaro/hovInd.js

@@ -19,7 +19,7 @@ const {doTest} = require('../procs/testaro');
 // FUNCTIONS
 
 // Runs the test and returns the result.
-exports.reporter = async (page, catalog, withItems) => {
+exports.reporter = async (page, report, _, withItems) => {
   const getBadWhat = element => {
     const violationTypes = [];
     const isVisible = element.checkVisibility({
@@ -140,5 +140,5 @@ exports.reporter = async (page, catalog, withItems) => {
   };
   const selector = 'body a, body button, body input, body [onmouseenter], body [onmouseover]';
   const whats = 'elements have confusing hover indicators';
-  return await doTest(page, catalog, withItems, 'hovInd', selector, whats, 1, getBadWhat.toString());
+  return await doTest(page, report.catalog, withItems, 'hovInd', selector, whats, 1, getBadWhat.toString());
 };

package/testaro/hover.js

@@ -64,7 +64,7 @@ const getVisibleCountChange = async (
 const getViolationDescription = (change, elapsedTime) =>
   `Hovering over the element changes the related visible element count by ${change} in ${elapsedTime}ms`;
 // Runs the test and returns the result.
-exports.reporter = async (page, catalog, withItems) => {
+exports.reporter = async (page, report, _, withItems) => {
   // Initialize the locators and result.
   const candidateLocs = await page.locator([
    '[aria-controls]:visible',
@@ -141,5 +141,5 @@ exports.reporter = async (page, catalog, withItems) => {
   }
   // Get and return a result.
   const whats = 'Hovering over elements changes the number of related visible elements';
-  return await getBasicResult(catalog, withItems, 'hover', 0, whats, data, violations);
+  return await getBasicResult(report.catalog, withItems, 'hover', 0, whats, data, violations);
 };

package/testaro/hr.js

@@ -20,13 +20,13 @@ const {doTest} = require('../procs/testaro');
 // FUNCTIONS
 
 // Runs the test and returns the result.
-exports.reporter = async (page, catalog, withItems) => {
+exports.reporter = async (page, report, _, withItems) => {
   const getBadWhat = element => {
     // Return a violation description.
     return `hr element is used for vertical segmentation`;
   }
   const whats = 'HR elements are used for vertical segmentation';
   return await doTest(
-    page, catalog, withItems, 'hr', 'body hr', whats, 0, getBadWhat.toString()
+    page, report.catalog, withItems, 'hr', 'body hr', whats, 0, getBadWhat.toString()
   );
 };

package/testaro/imageLink.js

@@ -22,7 +22,7 @@ const {doTest} = require('../procs/testaro');
 // FUNCTIONS
 
 // Runs the test and returns the result.
-exports.reporter = async (page, catalog, withItems) => {
+exports.reporter = async (page, report, _, withItems) => {
   const getBadWhat = element => {
     const href = element.getAttribute('href') || '';
     // If the destination of the element is an image file:
@@ -33,6 +33,6 @@ exports.reporter = async (page, catalog, withItems) => {
   };
   const whats = 'Links have image files as their destinations';
   return await doTest(
-    page, catalog, withItems, 'imageLink', 'body  a[href]', whats, 0, getBadWhat.toString()
+    page, report.catalog, withItems, 'imageLink', 'body  a[href]', whats, 0, getBadWhat.toString()
   );
 };

package/testaro/labClash.js

@@ -20,7 +20,7 @@ const {doTest} = require('../procs/testaro');
 // FUNCTIONS
 
 // Runs the test and returns the result.
-exports.reporter = async (page, catalog, withItems) => {
+exports.reporter = async (page, report, _, withItems) => {
   const getBadWhat = element => {
     // Get the label types of the element.
     const labelTypes = [];
@@ -44,6 +44,6 @@ exports.reporter = async (page, catalog, withItems) => {
   const selector = 'body button, body input:not([type=hidden]), body select, body textarea';
   const whats = 'Elements have inconsistent label types';
   return await doTest(
-    page, catalog, withItems, 'labClash', selector, whats, 2, getBadWhat.toString()
+    page, report.catalog, withItems, 'labClash', selector, whats, 2, getBadWhat.toString()
   );
 };