testaro 67.0.0 → 68.0.0

package/testaro/captionLoc.js

@@ -1,7 +1,7 @@
 /*
   © 2025 CVS Health and/or one of its affiliates. All rights reserved.
   © 2025 Juan S. Casado.
-  © 2025 Jonathan Robert Pool.
+  © 2025–2026 Jonathan Robert Pool.
 
   Licensed under the MIT License. See LICENSE file at the project root or
   https://opensource.org/license/mit/ for details.
@@ -20,7 +20,7 @@ const {doTest} = require('../procs/testaro');
 
 // FUNCTIONS
 
-exports.reporter = async (page, withItems) => {
+exports.reporter = async (page, catalog, 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, withItems) => {
   };
   const whats = 'caption elements are not the first children of table elements';
   return await doTest(
-    page, withItems, 'captionLoc', 'caption', whats, 3, 'CAPTION', getBadWhat.toString()
+    page, catalog, withItems, 'captionLoc', 'caption', whats, 3, getBadWhat.toString()
   );
 };

package/testaro/datalistRef.js

@@ -1,10 +1,9 @@
 /*
   © 2025 CVS Health and/or one of its affiliates. All rights reserved.
   © 2025 Juan S. Casado.
-  © 2025 Jonathan Robert Pool.
+  © 2025–2026 Jonathan Robert Pool.
 
-  Licensed under the MIT License. See LICENSE file at the project root or
-  https://opensource.org/license/mit/ for details.
+  Licensed under the MIT License. See LICENSE file at the project root or   https://opensource.org/license/mit/ for details.
 
   SPDX-License-Identifier: MIT
 */
@@ -20,7 +19,7 @@ const {doTest} = require('../procs/testaro');
 
 // FUNCTIONS
 
-exports.reporter = async (page, withItems) => {
+exports.reporter = async (page, catalog, withItems) => {
   const getBadWhat = element => {
     // Get the ID of the datalist element referenced by the list attribute of the element.
     const listID = element.getAttribute('list');
@@ -47,6 +46,6 @@ exports.reporter = async (page, withItems) => {
   };
   const whats = 'list attributes of input elements are empty or IDs of no or non-datalist elements';
   return await doTest(
-    page, withItems, 'datalistRef', 'input[list]', whats, 3, 'INPUT', getBadWhat.toString()
+    page, catalog, withItems, 'datalistRef', 'input[list]', whats, 3, getBadWhat.toString()
   );
 };

package/testaro/distortion.js

@@ -1,6 +1,6 @@
 /*
   © 2023 CVS Health and/or one of its affiliates. All rights reserved.
-  © 2025 Jonathan Robert Pool.
+  © 2025–2026 Jonathan Robert Pool.
 
   Licensed under the MIT License. See LICENSE file at the project root or
   https://opensource.org/license/mit/ for details.
@@ -21,7 +21,7 @@ const {doTest} = require('../procs/testaro');
 // FUNCTIONS
 
 // Runs the test and returns the result.
-exports.reporter = async (page, withItems) => {
+exports.reporter = async (page, catalog, withItems) => {
   const getBadWhat = element => {
     const styleDec = window.getComputedStyle(element);
     const {transform} = styleDec;
@@ -38,6 +38,6 @@ exports.reporter = async (page, withItems) => {
   };
   const whats = 'Elements distort their texts';
   return await doTest(
-    page, withItems, 'distortion', 'body *', whats, 0, null, getBadWhat.toString()
+    page, catalog, withItems, 'distortion', 'body *', whats, 0, getBadWhat.toString()
   );
 };

package/testaro/docType.js

@@ -1,5 +1,6 @@
 /*
   © 2022–2023 CVS Health and/or one of its affiliates. All rights reserved.
+  © 2026 Jonathan Robert Pool.
 
   Licensed under the MIT License. See LICENSE file at the project root or
   https://opensource.org/license/mit/ for details.
@@ -12,13 +13,16 @@
   Derived from the bbc-a11y allDocumentsMustHaveAW3cRecommendedDoctype test.
   This test reports a failure to equip the page document with a W3C-recommended HTML doctype.
 */
+
+// Runs the test and returns the result.
 exports.reporter = async page => {
-  // Identify the visible links without href attributes.
+  // Returns whether the page declares a document type.
   const docHasType = await page.evaluate(() => {
     const docType = document.doctype;
     const docHasType = !! docType && docType.name && docType.name.toLowerCase() === 'html';
     return docHasType;
   });
+  // Return data, totals, and, if no document type is declared, a standard instance.
   return {
     data: {docHasType},
     totals: [0, 0, 0, docHasType ? 0 : 1],
@@ -26,14 +30,7 @@ exports.reporter = async page => {
       ruleID: 'docType',
       what: 'Document has no standard HTML doctype preamble',
       ordinalSeverity: 3,
-      tagName: 'HTML',
-      id: '',
-      location: {
-        doc: 'dom',
-        type: 'selector',
-        spec: 'html'
-      },
-      excerpt: ''
+      count: 1
     }]
   };
 };

package/testaro/dupAtt.js

@@ -1,15 +1,15 @@
 /*
   © 2023–2024 CVS Health and/or one of its affiliates. All rights reserved.
+  © 2026 Jonathan Robert Pool.
 
-  Licensed under the MIT License. See LICENSE file at the project root or
-  https://opensource.org/license/mit/ for details.
+  Licensed under the MIT License. See LICENSE file at the project root or  https://opensource.org/license/mit/ for details.
 
   SPDX-License-Identifier: MIT
 */
 
 /*
   dupAtt.js
-  This test reports duplicate attributes in the source of a document.
+  This test reports duplicate attributes. The test is performed on the source of the document, because browsers delete additional same-name attributes in the DOM.
 */
 
 // ########## IMPORTS
@@ -19,8 +19,8 @@ const {getSource} = require('../procs/getSource');
 
 // ########## FUNCTIONS
 
-// Reports failures.
-exports.reporter = async (page, withItems) => {
+// Runs the test and returns the result.
+exports.reporter = async (page, _, withItems) => {
   // Initialize the data and standard result.
   const data = {total: 0};
   if (withItems) {
@@ -88,38 +88,25 @@ exports.reporter = async (page, withItems) => {
     });
     // If itemization is required and there are any instances:
     if (data.items) {
-      // For each instance:
+      // For each violator:
       data.items.forEach(item => {
-        // Add it.
+        // Add an instance to the standard instances.
         standardInstances.push({
           ruleID: 'dupAtt',
-          what: 'Element has 2 attributes with the same name',
+          what: `${item.tagName} element has 2 attributes named ${item.duplicatedAttribute}`,
           ordinalSeverity: 2,
-          tagName: item.tagName,
-          id: item.id,
-          location: {
-            doc: item.id ? 'source' : '',
-            type: item.id ? 'selector' : '',
-            spec: item.id ? `#${item.id}` : ''
-          },
-          excerpt: item.duplicatedAttribute
+          count: 1
         });
       });
     }
-    // Otherwise, if there are any instances:
+    // Otherwise, if itemization is not required and there are any violations:
     else if (data.total) {
-      // Add a summary instance.
+      // Add a summary instance to the standard instances.
       standardInstances.push({
         ruleID: 'dupAtt',
         what: 'In some elements 2 attributes have the same name',
         ordinalSeverity: 2,
-        count: data.total,
-        location: {
-          doc: '',
-          type: '',
-          spec: ''
-        },
-        excerpt: ''
+        count: data.total
       });
     }
     totals = [0, 0, data.total, 0];

package/testaro/elements.js

@@ -1,8 +1,8 @@
 /*
   © 2023 CVS Health and/or one of its affiliates. All rights reserved.
+  © 2026 Jonathan Robert Pool.
 
-  Licensed under the MIT License. See LICENSE file at the project root or
-  https://opensource.org/license/mit/ for details.
+  Licensed under the MIT License. See LICENSE file at the project root or   https://opensource.org/license/mit/ for details.
 
   SPDX-License-Identifier: MIT
 */
@@ -15,8 +15,9 @@
   2. Data on each specified element also include the text content of the parent element.
   3. Data on each specified element also include data on its sibling nodes.
 */
+
 exports.reporter = async (
-  page, withItems, detailLevel = 0, tagName = null, onlyVisible = false, attribute
+  page, _, _, detailLevel = 0, tagName = null, onlyVisible = false, attribute
 ) => {
   // Determine a selector of the specified elements, including any descendants of open shadow roots.
   let selector = `body ${tagName ? tagName.toLowerCase() : '*'}`;

package/testaro/embAc.js

@@ -1,5 +1,6 @@
 /*
   © 2021–2023 CVS Health and/or one of its affiliates. All rights reserved.
+  © 2026 Jonathan Robert Pool.
 
   Licensed under the MIT License. See LICENSE file at the project root or
   https://opensource.org/license/mit/ for details.
@@ -18,7 +19,8 @@ const {doTest} = require('../procs/testaro');
 
 // FUNCTIONS
 
-exports.reporter = async (page, withItems) => {
+// Runs the test and returns the result.
+exports.reporter = async (page, catalog, withItems) => {
   const getBadWhat = element => {
     // Get whether the embedding element is a link or a button.
     const embedder = element.parentElement.closest('a, button');
@@ -30,5 +32,5 @@ exports.reporter = async (page, withItems) => {
   .map(tag => `a ${tag}, button ${tag}`)
   .join(', ');
   const whats = 'interactive elements are embedded in links or buttons';
-  return await doTest(page, withItems, 'embAc', selector, whats, 2, null, getBadWhat.toString());
+  return await doTest(page, catalog, withItems, 'embAc', selector, whats, 2, getBadWhat.toString());
 };

package/testaro/focAll.js

@@ -1,9 +1,8 @@
 /*
   © 2021–2023 CVS Health and/or one of its affiliates. All rights reserved.
-  © 2025 Jonathan Robert Pool.
+  © 2025–2026 Jonathan Robert Pool.
 
-  Licensed under the MIT License. See LICENSE file at the project root or
-  https://opensource.org/license/mit/ for details.
+  Licensed under the MIT License. See LICENSE file at the project root or  https://opensource.org/license/mit/ for details.
 
   SPDX-License-Identifier: MIT
 */
@@ -12,6 +11,8 @@
   focAll
   This test reports discrepancies between focusable and Tab-focused element counts. The test first counts all the visible focusable (i.e. with tabIndex 0) elements (except counting each group of radio buttons as only one focusable element). Then it repeatedly presses the Tab (or Option-Tab in webkit) key until it has reached all the elements it can and counts those elements. If the two counts differ, navigation can be made more difficult. The cause may be surprising changes in content during navigation with the Tab key, or inability to reach every focusable element (or widget, such as one radio button or tab in each group) merely by pressing the Tab key.
 */
+
+// Runs the test and returns the result.
 exports.reporter = async page => {
   // Get locators of visible elements.
   const locAll = await page.locator('body *:visible');
@@ -32,7 +33,7 @@ exports.reporter = async page => {
   */
   let tabFocused = 0;
   let refocused = 0;
-  const keyName = page.browserID === 'webkit' ? 'Alt+Tab' : 'Tab';
+  const keyName = page.context().browser()?.browserType().name() === 'webkit' ? 'Alt+Tab' : 'Tab';
   while (refocused < 100 && tabFocused < 2000) {
     await page.keyboard.press(keyName);
     const isNewFocus = await page.evaluate(() => {
@@ -65,16 +66,8 @@ exports.reporter = async page => {
     standardInstances: count ? [{
       ruleID: 'focAll',
       what: 'Some focusable elements are not Tab-focusable or vice versa',
-      count,
       ordinalSeverity: 2,
-      tagName: '',
-      id: '',
-      location: {
-        doc: '',
-        type: '',
-        spec: ''
-      },
-      excerpt: ''
+      count
     }] : []
   };
 };

package/testaro/focAndOp.js

@@ -1,6 +1,6 @@
 /*
   © 2021–2024 CVS Health and/or one of its affiliates. All rights reserved.
-  © 2025 Jonathan Robert Pool.
+  © 2025–2026 Jonathan Robert Pool.
 
   Licensed under the MIT License. See LICENSE file at the project root or
   https://opensource.org/license/mit/ for details.
@@ -22,7 +22,7 @@ const {doTest} = require('../procs/testaro');
 // FUNCTIONS
 
 // Runs the test and returns the result.
-exports.reporter = async (page, withItems) => {
+exports.reporter = async (page, catalog, withItems) => {
   const getBadWhat = element => {
     // Get whether the element is visible.
     const isVisible = element.checkVisibility({
@@ -116,6 +116,6 @@ exports.reporter = async (page, withItems) => {
   };
   const whats = 'Elements are Tab-focusable but not operable or vice versa';
   return await doTest(
-    page, withItems, 'focAndOp', 'body *', whats, 2, null, getBadWhat.toString()
+    page, catalog, withItems, 'focAndOp', 'body *', whats, 2, getBadWhat.toString()
   );
 };

package/testaro/focInd.js

@@ -1,6 +1,6 @@
 /*
   © 2021–2023 CVS Health and/or one of its affiliates. All rights reserved.
-  © 2025 Jonathan Robert Pool.
+  © 2025–2026 Jonathan Robert Pool.
 
   Licensed under the MIT License. See LICENSE file at the project root or
   https://opensource.org/license/mit/ for details.
@@ -27,7 +27,7 @@ const {doTest} = require('../procs/testaro');
 // FUNCTIONS
 
 // Runs the test and returns the result.
-exports.reporter = async (page, withItems) => {
+exports.reporter = async (page, catalog, withItems) => {
   const getBadWhat = element => {
     // Get whether the element is visible.
     const isVisible = element.checkVisibility({
@@ -86,6 +86,6 @@ exports.reporter = async (page, withItems) => {
   };
   const whats = 'Elements fail to have standard focus indicators';
   return await doTest(
-    page, withItems, 'focInd', 'body *', whats, 1, null, getBadWhat.toString()
+    page, catalog, withItems, 'focInd', 'body *', whats, 1, getBadWhat.toString()
   );
 };

package/testaro/focVis.js

@@ -1,6 +1,6 @@
 /*
   © 2022–2025 CVS Health and/or one of its affiliates. All rights reserved.
-  © 2025 Jonathan Robert Pool.
+  © 2025–2026 Jonathan Robert Pool.
 
   Licensed under the MIT License. See LICENSE file at the project root or
   https://opensource.org/license/mit/ for details.
@@ -20,7 +20,8 @@ const {doTest} = require('../procs/testaro');
 
 // FUNCTIONS
 
-exports.reporter = async (page, withItems) => {
+// Runs the test and returns the result.
+exports.reporter = async (page, catalog, withItems) => {
   const getBadWhat = element => {
     const isVisible = element.checkVisibility({
       contentVisibilityAuto: true,
@@ -41,6 +42,6 @@ exports.reporter = async (page, withItems) => {
   };
   const whats = 'Visible links are above or to the left of the display';
   return await doTest(
-    page, withItems, 'focVis', 'a', whats, 2, 'A', getBadWhat.toString()
+    page, catalog, withItems, 'focVis', 'a', whats, 2, getBadWhat.toString()
   );
 };

package/testaro/headEl.js

@@ -1,9 +1,8 @@
 /*
   © 2023–2024 CVS Health and/or one of its affiliates. All rights reserved.
-  © 2025 Jonathan Robert Pool.
+  © 2025–2026 Jonathan Robert Pool.
 
-  Licensed under the MIT License. See LICENSE file at the project root or
-  https://opensource.org/license/mit/ for details.
+  Licensed under the MIT License. See LICENSE file at the project root or   https://opensource.org/license/mit/ for details.
 
   SPDX-License-Identifier: MIT
 */
@@ -16,7 +15,7 @@
 
 // ########## FUNCTIONS
 
-// Performs the test.
+// Runs the test and returns the result.
 exports.reporter = async page => {
   // Initialize the data and standard result.
   const data = {
@@ -56,18 +55,12 @@ exports.reporter = async page => {
   });
   // If there are any instances:
   if (data.total) {
-    // Add a summary instance.
+    // Add a summary instance to the standard instances.
     standardInstances.push({
       ruleID: 'headEl',
       what: `Invalid elements within the head: ${data.badTagNames.join(', ')}`,
       ordinalSeverity: 2,
-      count: data.total,
-      location: {
-        doc: '',
-        type: '',
-        spec: ''
-      },
-      excerpt: ''
+      count: data.total
     });
   }
   totals = [0, 0, data.total, 0];

package/testaro/headingAmb.js

@@ -1,8 +1,8 @@
 /*
   © 2023–2024 CVS Health and/or one of its affiliates. All rights reserved.
+  © 2026 Jonathan Robert Pool.
 
-  Licensed under the MIT License. See LICENSE file at the project root or
-  https://opensource.org/license/mit/ for details.
+  Licensed under the MIT License. See LICENSE file at the project root or  https://opensource.org/license/mit/ for details.
 
   SPDX-License-Identifier: MIT
 */
@@ -13,101 +13,58 @@
   This test reports adjacent headings with the same levels and text contents.
 */
 
-// ########## IMPORTS
+// IMPORTS
 
-// Module to get locator data.
-const {getLocatorData} = require('../procs/getLocatorData');
+const {doTest} = require('../procs/testaro');
 
 // ########## FUNCTIONS
 
-// Performs the test.
-exports.reporter = async (page, withItems) => {
-  // Initialize the standard result.
-  const data = {};
-  const totals = [0, 0, 0, 0];
-  const standardInstances = [];
-  // Get locators for all the headings.
-  const headingLevels = [1, 2, 3, 4, 5, 6];
-  const locAll = page.locator(headingLevels.map(level => `body h${level}`).join(', '));
-  const locsAll = await locAll.all();
-  const ambIndexes = await locAll.evaluateAll(headings => {
-    // Initialize the array of indexes of violating headings.
-    const badIndexes = [];
-    // For each heading:
-    headings.forEach((heading, index) => {
-      // Get its level.
-      const level = heading.tagName[1];
-      // Get the prior headings.
-      const priorHeadings = headings.slice(0, index);
-      // Get the non-inferior ones among them.
-      const nonInferiors = priorHeadings.filter(priorHeading => priorHeading.tagName[1] <= level);
-      // If there are any:
-      const nonInferiorCount = nonInferiors.length;
-      if (nonInferiorCount) {
-        // Get the last of them.
-        const prior = nonInferiors[nonInferiorCount - 1];
-        // If they have the same level and text:
-        if (['tagName', 'textContent'].every(property => prior[property] === heading[property])) {
-          // Add the index of the later heading to the index of violating headings.
-          badIndexes.push(index);
+// Runs the test and returns the result.
+exports.reporter = async (page, catalog, withItems) => {
+  const getBadWhat = element => {
+    const {tagName} = element;
+    const level = tagName[1];
+    const textContent = element.textContent.trim().replace(/\s+/g, ' ');
+    const headingTagNames = ['H1', 'H2', 'H3', 'H4', 'H5', 'H6'];
+    // Initialize the inspected element as the previous element sibling of the element.
+    let inspectedElement = element.previousElementSibling;
+    // As long as the inspected element exists:
+    while (inspectedElement) {
+      const inspectedTagName = inspectedElement.tagName;
+      // If it is a heading:
+      if (headingTagNames.includes(inspectedTagName)) {
+        // If it is inferior to the element:
+        if (inspectedTagName[1] > level) {
+          // Stop inspecting it and start inspecting its previous sibling.
+          inspectedElement = inspectedElement.previousElementSibling;
+          continue;
         }
-      }
-    });
-    return badIndexes;
-  });
-  // If there were any instances:
-  if (ambIndexes.length) {
-    // Add to the totals.
-    totals[1] = ambIndexes.length;
-    // If itemization is required:
-    if (withItems) {
-      // For each instance:
-      for (const index of ambIndexes) {
-        // If it exists:
-        const loc = locsAll[index];
-        if (loc) {
-          // Get data on the element.
-          const elData = await getLocatorData(loc);
-          // Add a standard instance.
-          standardInstances.push({
-            ruleID: 'headingAmb',
-            what: 'Heading has the same text as the prior same-level sibling heading',
-            ordinalSeverity: 1,
-            tagName: elData.tagName,
-            id: elData.id,
-            location: elData.location,
-            excerpt: elData.excerpt
-          });
+        // Otherwise, if its level is the same as that of the element:
+        else if (inspectedTagName === tagName) {
+          const inspectedTextContent = inspectedElement.textContent.trim().replace(/\s+/g, ' ');
+          // If they have identical text contents:
+          if (inspectedTextContent === textContent) {
+            // Return a violation description.
+            return 'Heading has the same text as the prior same-level sibling heading';
+          }
         }
-        // Otherwise, i.e. if it does not exist:
+        // Otherwise, i.e. if it is superior to the element:
         else {
-          // Report this.
-          console.log('ERROR: Reportedly same-text adjacent sibling heading not found');
+          // Stop inspecting.
+          break;
         }
       }
+      // Otherwise, i.e. if it is not a heading:
+      else {
+        // Inspect its previous sibling.
+        inspectedElement = inspectedElement.previousElementSibling;
+      }
     }
-    // Otherwise, i.e. if itemization is not required:
-    else {
-      // Add a summary instance.
-      standardInstances.push({
-        ruleID: 'headingAmb',
-        what: 'Adjacent sibling same-level headings have the same text',
-        ordinalSeverity: 1,
-        count: totals[1],
-        tagName: '',
-        id: '',
-        location: {
-          doc: '',
-          type: '',
-          spec: ''
-        },
-        excerpt: ''
-      });
-    }
-  }
-  return {
-    data,
-    totals,
-    standardInstances
   };
+  const headingLevels = [1, 2, 3, 4, 5, 6];
+  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()
+  );
 };

package/testaro/hovInd.js

@@ -1,9 +1,8 @@
 /*
   © 2023–2025 CVS Health and/or one of its affiliates. All rights reserved.
-  © 2025 Jonathan Robert Pool.
+  © 2025–2026 Jonathan Robert Pool.
 
-  Licensed under the MIT License. See LICENSE file at the project root or
-  https://opensource.org/license/mit/ for details.
+  Licensed under the MIT License. See LICENSE file at the project root or  https://opensource.org/license/mit/ for details.
 
   SPDX-License-Identifier: MIT
 */
@@ -19,7 +18,8 @@ const {doTest} = require('../procs/testaro');
 
 // FUNCTIONS
 
-exports.reporter = async (page, withItems) => {
+// Runs the test and returns the result.
+exports.reporter = async (page, _, withItems) => {
   const getBadWhat = element => {
     const violationTypes = [];
     const isVisible = element.checkVisibility({
@@ -140,5 +140,5 @@ exports.reporter = async (page, withItems) => {
   };
   const selector = 'a, button, input, [onmouseenter], [onmouseover]';
   const whats = 'elements have confusing hover indicators';
-  return await doTest(page, withItems, 'hovInd', selector, whats, 1, null, getBadWhat.toString());
+  return await doTest(page, withItems, 'hovInd', selector, whats, 1, getBadWhat.toString());
 };