testaro 78.0.8 → 78.4.0

package/testaro/textNodes.js

@@ -1,3 +1,4 @@
+"use strict";
 /*
   © 2023–2024 CVS Health and/or one of its affiliates. All rights reserved.
   © 2026 Jonathan Robert Pool.
@@ -7,150 +8,153 @@
 
   SPDX-License-Identifier: MIT
 */
-
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reporter = void 0;
 /*
   textNodes
   This test reports data about specified text nodes. Meanings of detailLevel values:
   0. Only total node count; no detail.
   1-3. Count of ancestry levels to provide data on (1 = text node, 2 = also parent, 3 = also grandparent)
+  Compiled to textNodes.js by tsc (issue #73); edit this file, not the emitted one.
 */
-
 // FUNCTIONS
-
 // Runs the test and returns the result.
-exports.reporter = async (page, _0, _1, _2, detailLevel, text = '') => {
-  let data = {};
-  // Get the data on the text nodes.
-  try {
-    data = await page.evaluate(args => {
-      const detailLevel = args[0];
-      const text = args[1];
-      const matchNodes = [];
-      // Collapse any adjacent text nodes.
-      document.body.normalize();
-      // Remove the irrelevant text content.
-      const extraElements = Array.from(document.body.querySelectorAll('style, script, svg'));
-      extraElements.forEach(element => {
-        element.textContent = '';
-      });
-      // FUNCTION DEFINITIONS START
-      // Compacts a string.
-      const compact = string => string.replace(/\s+/g, ' ').trim();
-      // Compacts and lower-cases a string.
-      const toStandardString = string => compact(string).toLowerCase();
-      /*
-        Gets data (tagName, text if specified, attributes, refLabels, labels, and children)
-        on an element.
-      */
-      const getElementData = (element, withText) => {
-        // Initialize the data.
-        const data = {
-          tagName: element.tagName
-        };
-        if (! ['STYLE', 'SCRIPT', 'SVG', 'svg'].includes(element.tagName)) {
-          if (withText) {
-            data.text = compact(element.textContent);
-          }
-          // Add data on its attributes, if any, to the data.
-          const {attributes} = element;
-          if (attributes) {
-            data.attributes = [];
-            for (const attribute of attributes) {
-              const {name, value} = attribute;
-              data.attributes.push({
-                name,
-                value
-              });
-              // If any attribute is a labeler reference:
-              if (name === 'aria-labelledby') {
-                // Add the label texts to the data.
-                const labelerIDs = value.split(/\s+/);
-                data.refLabels = [];
-                labelerIDs.forEach(id => {
-                  const labeler = document.getElementById(id);
-                  if (labeler) {
-                    data.refLabels.push(compact(labeler.textContent));
-                  }
-                });
-              }
-            }
-          }
-          // Add data on its labels, if any, to the data.
-          const {labels} = element;
-          if (labels && labels.length) {
-            data.labels = Array.from(labels).map(label => compact(label.textContent));
-          }
-          // Add data on its child elements, if any, to the data.
-          if (element.childElementCount) {
-            const children = Array.from(element.children);
-            data.children = [];
-            children.forEach(child => {
-              data.children.push(getElementData(child, true));
+const reporter = async (page, _0, _1, _2, detailLevel, text = '') => {
+    let data = {};
+    // Get the data on the text nodes.
+    try {
+        data = await page.evaluate(args => {
+            const detailLevel = args[0];
+            const text = args[1];
+            const matchNodes = [];
+            // Collapse any adjacent text nodes.
+            document.body.normalize();
+            // Remove the irrelevant text content.
+            const extraElements = Array.from(document.body.querySelectorAll('style, script, svg'));
+            extraElements.forEach(element => {
+                element.textContent = '';
             });
-          }
-        }
-        return data;
-      };
-      // FUNCTION DEFINITIONS END
-      const stdText = toStandardString(text);
-      // Create a collection of the text nodes.
-      const walker = document.createTreeWalker(document.body, NodeFilter.SHOW_TEXT);
-      // Get their count.
-      const data = {nodeCount: 0};
-      let more = true;
-      while(more) {
-        if (walker.nextNode()) {
-          const stdCurrent = toStandardString(walker.currentNode.nodeValue);
-          if (stdCurrent.includes(stdText)) {
-            data.nodeCount++;
-            matchNodes.push(walker.currentNode);
-          }
-        }
-        else {
-          more = false;
-        }
-      }
-      // If itemization is required:
-      if (detailLevel > 0) {
-        // Initialize the item data.
-        data.items = [];
-        // For each text node matching any specified text:
-        matchNodes.forEach(node => {
-          // Initialize the data on it.
-          const itemData = {text: compact(node.nodeValue)};
-          // If ancestral itemization is required:
-          if (detailLevel > 1) {
-            // Add the ancestral data, starting with the parent, to the item data.
-            itemData.ancestors = [];
-            let base = node;
-            let currentLevel = 1;
-            // For each specified ancestral distance:
-            while(currentLevel++ < detailLevel) {
-              // Add data on it to the data on the text node.
-              const newBase = base.parentElement;
-              // Omit the text of the text node if the ancestor is its parent.
-              itemData.ancestors.push(getElementData(newBase, currentLevel > 2));
-              base = newBase;
+            // FUNCTION DEFINITIONS START
+            // Compacts a string.
+            const compact = (string) => string.replace(/\s+/g, ' ').trim();
+            // Compacts and lower-cases a string.
+            const toStandardString = (string) => compact(string).toLowerCase();
+            /*
+              Gets data (tagName, text if specified, attributes, refLabels, labels, and children)
+              on an element.
+            */
+            const getElementData = (element, withText) => {
+                // Initialize the data.
+                const data = {
+                    tagName: element.tagName
+                };
+                if (!['STYLE', 'SCRIPT', 'SVG', 'svg'].includes(element.tagName)) {
+                    if (withText) {
+                        data.text = compact(element.textContent);
+                    }
+                    // Add data on its attributes, if any, to the data.
+                    const { attributes } = element;
+                    if (attributes) {
+                        data.attributes = [];
+                        for (const attribute of attributes) {
+                            const { name, value } = attribute;
+                            data.attributes.push({
+                                name,
+                                value
+                            });
+                            // If any attribute is a labeler reference:
+                            if (name === 'aria-labelledby') {
+                                // Add the label texts to the data.
+                                const labelerIDs = value.split(/\s+/);
+                                data.refLabels = [];
+                                labelerIDs.forEach(id => {
+                                    const labeler = document.getElementById(id);
+                                    if (labeler) {
+                                        data.refLabels.push(compact(labeler.textContent));
+                                    }
+                                });
+                            }
+                        }
+                    }
+                    // Add data on its labels, if any, to the data.
+                    const { labels } = element;
+                    if (labels && labels.length) {
+                        data.labels = Array.from(labels).map(label => compact(label.textContent));
+                    }
+                    // Add data on its child elements, if any, to the data.
+                    if (element.childElementCount) {
+                        const children = Array.from(element.children);
+                        data.children = [];
+                        children.forEach(child => {
+                            data.children.push(getElementData(child, true));
+                        });
+                    }
+                }
+                return data;
+            };
+            // FUNCTION DEFINITIONS END
+            const stdText = toStandardString(text);
+            // Create a collection of the text nodes.
+            const walker = document.createTreeWalker(document.body, NodeFilter.SHOW_TEXT);
+            // Get their count.
+            const data = { nodeCount: 0 };
+            let more = true;
+            while (more) {
+                if (walker.nextNode()) {
+                    const stdCurrent = toStandardString(walker.currentNode.nodeValue);
+                    if (stdCurrent.includes(stdText)) {
+                        data.nodeCount++;
+                        matchNodes.push(walker.currentNode);
+                    }
+                }
+                else {
+                    more = false;
+                }
+            }
+            // If itemization is required:
+            if (detailLevel > 0) {
+                // Initialize the item data.
+                data.items = [];
+                // For each text node matching any specified text:
+                matchNodes.forEach(node => {
+                    // Initialize the data on it.
+                    const itemData = {
+                        text: compact(node.nodeValue)
+                    };
+                    // If ancestral itemization is required:
+                    if (detailLevel > 1) {
+                        // Add the ancestral data, starting with the parent, to the item data.
+                        itemData.ancestors = [];
+                        let base = node;
+                        let currentLevel = 1;
+                        // For each specified ancestral distance:
+                        while (currentLevel++ < detailLevel) {
+                            // Add data on it to the data on the text node.
+                            const newBase = base.parentElement;
+                            // Omit the text of the text node if the ancestor is its parent.
+                            itemData.ancestors.push(getElementData(newBase, currentLevel > 2));
+                            base = newBase;
+                        }
+                    }
+                    // Add the node data to the itemization.
+                    data.items.push(itemData);
+                });
             }
-          }
-          // Add the node data to the itemization.
-          data.items.push(itemData);
-        });
-      }
-      return data;
-    }, [detailLevel, text]);
-  }
-  catch(error) {
-    console.log(`ERROR performing test (${error.message.replace(/\n.+/s, '')})`);
-    data = {
-      prevented: true,
-      error: 'Test failed'
+            return data;
+        }, [detailLevel, text]);
+    }
+    catch (error) {
+        console.log(`ERROR performing test (${error.message.replace(/\n.+/s, '')})`);
+        data = {
+            prevented: true,
+            error: 'Test failed'
+        };
+    }
+    // Return the result.
+    return {
+        data,
+        totals: [],
+        standardInstances: []
     };
-  }
-  // Return the result.
-  return {
-    data,
-    totals: [],
-    standardInstances: []
-  };
 };
+exports.reporter = reporter;

package/testaro/textNodes.ts

@@ -0,0 +1,185 @@
+/*
+  © 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.
+
+  SPDX-License-Identifier: MIT
+*/
+
+// IMPORTS
+
+import type {Page} from 'playwright';
+
+// TYPES
+
+// Data on one attribute of an element.
+interface AttributeDatum {
+  name: string;
+  value: string;
+}
+// Data on an element, possibly with data on its descendants.
+interface ElementData {
+  tagName: string;
+  text?: string;
+  attributes?: AttributeDatum[];
+  refLabels?: string[];
+  labels?: string[];
+  children?: ElementData[];
+}
+
+/*
+  textNodes
+  This test reports data about specified text nodes. Meanings of detailLevel values:
+  0. Only total node count; no detail.
+  1-3. Count of ancestry levels to provide data on (1 = text node, 2 = also parent, 3 = also grandparent)
+  Compiled to textNodes.js by tsc (issue #73); edit this file, not the emitted one.
+*/
+
+// FUNCTIONS
+
+// Runs the test and returns the result.
+export const reporter = async (
+  page: Page, _0: unknown, _1: unknown, _2: unknown, detailLevel: number, text = ''
+) => {
+  let data: Record<string, unknown> = {};
+  // Get the data on the text nodes.
+  try {
+    data = await page.evaluate(args => {
+      const detailLevel = args[0];
+      const text = args[1];
+      const matchNodes: Node[] = [];
+      // Collapse any adjacent text nodes.
+      document.body.normalize();
+      // Remove the irrelevant text content.
+      const extraElements = Array.from(document.body.querySelectorAll('style, script, svg'));
+      extraElements.forEach(element => {
+        element.textContent = '';
+      });
+      // FUNCTION DEFINITIONS START
+      // Compacts a string.
+      const compact = (string: string) => string.replace(/\s+/g, ' ').trim();
+      // Compacts and lower-cases a string.
+      const toStandardString = (string: string) => compact(string).toLowerCase();
+      /*
+        Gets data (tagName, text if specified, attributes, refLabels, labels, and children)
+        on an element.
+      */
+      const getElementData = (element: Element, withText: boolean): ElementData => {
+        // Initialize the data.
+        const data: ElementData = {
+          tagName: element.tagName
+        };
+        if (! ['STYLE', 'SCRIPT', 'SVG', 'svg'].includes(element.tagName)) {
+          if (withText) {
+            data.text = compact(element.textContent!);
+          }
+          // Add data on its attributes, if any, to the data.
+          const {attributes} = element;
+          if (attributes) {
+            data.attributes = [];
+            for (const attribute of attributes) {
+              const {name, value} = attribute;
+              data.attributes.push({
+                name,
+                value
+              });
+              // If any attribute is a labeler reference:
+              if (name === 'aria-labelledby') {
+                // Add the label texts to the data.
+                const labelerIDs = value.split(/\s+/);
+                data.refLabels = [];
+                labelerIDs.forEach(id => {
+                  const labeler = document.getElementById(id);
+                  if (labeler) {
+                    data.refLabels!.push(compact(labeler.textContent!));
+                  }
+                });
+              }
+            }
+          }
+          // Add data on its labels, if any, to the data.
+          const {labels} = element as HTMLInputElement;
+          if (labels && labels.length) {
+            data.labels = Array.from(labels).map(label => compact(label.textContent!));
+          }
+          // Add data on its child elements, if any, to the data.
+          if (element.childElementCount) {
+            const children = Array.from(element.children);
+            data.children = [];
+            children.forEach(child => {
+              data.children!.push(getElementData(child, true));
+            });
+          }
+        }
+        return data;
+      };
+      // FUNCTION DEFINITIONS END
+      const stdText = toStandardString(text);
+      // Create a collection of the text nodes.
+      const walker = document.createTreeWalker(document.body, NodeFilter.SHOW_TEXT);
+      // Get their count.
+      const data: {
+        nodeCount: number;
+        items?: {text: string; ancestors?: ElementData[]}[];
+      } = {nodeCount: 0};
+      let more = true;
+      while(more) {
+        if (walker.nextNode()) {
+          const stdCurrent = toStandardString(walker.currentNode.nodeValue!);
+          if (stdCurrent.includes(stdText)) {
+            data.nodeCount++;
+            matchNodes.push(walker.currentNode);
+          }
+        }
+        else {
+          more = false;
+        }
+      }
+      // If itemization is required:
+      if (detailLevel > 0) {
+        // Initialize the item data.
+        data.items = [];
+        // For each text node matching any specified text:
+        matchNodes.forEach(node => {
+          // Initialize the data on it.
+          const itemData: {text: string; ancestors?: ElementData[]} = {
+            text: compact(node.nodeValue!)
+          };
+          // If ancestral itemization is required:
+          if (detailLevel > 1) {
+            // Add the ancestral data, starting with the parent, to the item data.
+            itemData.ancestors = [];
+            let base: Node = node;
+            let currentLevel = 1;
+            // For each specified ancestral distance:
+            while(currentLevel++ < detailLevel) {
+              // Add data on it to the data on the text node.
+              const newBase = base.parentElement;
+              // Omit the text of the text node if the ancestor is its parent.
+              itemData.ancestors!.push(getElementData(newBase!, currentLevel > 2));
+              base = newBase!;
+            }
+          }
+          // Add the node data to the itemization.
+          data.items!.push(itemData);
+        });
+      }
+      return data;
+    }, [detailLevel, text] as const);
+  }
+  catch(error) {
+    console.log(`ERROR performing test (${(error as Error).message.replace(/\n.+/s, '')})`);
+    data = {
+      prevented: true,
+      error: 'Test failed'
+    };
+  }
+  // Return the result.
+  return {
+    data,
+    totals: [],
+    standardInstances: []
+  };
+};

package/testaro/textSem.d.ts

@@ -0,0 +1,3 @@
+import type { Page } from 'playwright';
+import type { Report } from '../types';
+export declare const reporter: (page: Page, report: Report, _: unknown, withItems: boolean) => Promise<import("../procs/testaro").RuleResult>;

package/testaro/textSem.js

@@ -1,3 +1,4 @@
+"use strict";
 /*
   © 2025 CVS Health and/or one of its affiliates. All rights reserved.
   © 2026 Jeff Witt.
@@ -7,38 +8,34 @@
 
   SPDX-License-Identifier: MIT
 */
-
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reporter = void 0;
+const testaro_1 = require("../procs/testaro");
 /*
   textSem
   This test reports semantically vague inline elements: i, b, small.
+  Compiled to textSem.js by tsc (issue #73); edit this file, not the emitted one.
 */
-
-// IMPORTS
-
-const {doTest} = require('../procs/testaro');
-
 // FUNCTIONS
-
 // Runs the test and returns the result.
-exports.reporter = async (page, report, _, withItems) => {
-  const getBadWhat = element => {
-    const isVisible = element.checkVisibility({
-      contentVisibilityAuto: true,
-      opacityProperty: true,
-      visibilityProperty: true
-    });
-    // If the element is visible:
-    if (isVisible) {
-      // If it has text content:
-      if (element.textContent.trim().replace(/\s/g, '')) {
-        // Return a violation description.
-        return `Element type (${element.tagName}) is semantically vague`;
-      }
-    }
-  };
-  const selector = 'body i, body b, body small';
-  const whats = 'Semantically vague elements i, b, and/or small are used';
-  return await doTest(
-    page, report, withItems, 'textSem', selector, whats, 0, getBadWhat.toString()
-  );
+const reporter = async (page, report, _, withItems) => {
+    const getBadWhat = element => {
+        const isVisible = element.checkVisibility({
+            contentVisibilityAuto: true,
+            opacityProperty: true,
+            visibilityProperty: true
+        });
+        // If the element is visible:
+        if (isVisible) {
+            // If it has text content:
+            if (element.textContent.trim().replace(/\s/g, '')) {
+                // Return a violation description.
+                return `Element type (${element.tagName}) is semantically vague`;
+            }
+        }
+    };
+    const selector = 'body i, body b, body small';
+    const whats = 'Semantically vague elements i, b, and/or small are used';
+    return await (0, testaro_1.doTest)(page, report, withItems, 'textSem', selector, whats, 0, getBadWhat.toString());
 };
+exports.reporter = reporter;

package/testaro/textSem.ts

@@ -0,0 +1,47 @@
+/*
+  © 2025 CVS Health and/or one of its affiliates. All rights reserved.
+  © 2026 Jeff Witt.
+  © 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.
+
+  SPDX-License-Identifier: MIT
+*/
+
+// IMPORTS
+
+import type {Page} from 'playwright';
+import {doTest} from '../procs/testaro';
+import type {GetBadWhat, Report} from '../types';
+
+/*
+  textSem
+  This test reports semantically vague inline elements: i, b, small.
+  Compiled to textSem.js by tsc (issue #73); edit this file, not the emitted one.
+*/
+
+// FUNCTIONS
+
+// Runs the test and returns the result.
+export const reporter = async (page: Page, report: Report, _: unknown, withItems: boolean) => {
+  const getBadWhat: GetBadWhat = element => {
+    const isVisible = element.checkVisibility({
+      contentVisibilityAuto: true,
+      opacityProperty: true,
+      visibilityProperty: true
+    });
+    // If the element is visible:
+    if (isVisible) {
+      // If it has text content:
+      if (element.textContent.trim().replace(/\s/g, '')) {
+        // Return a violation description.
+        return `Element type (${element.tagName}) is semantically vague`;
+      }
+    }
+  };
+  const selector = 'body i, body b, body small';
+  const whats = 'Semantically vague elements i, b, and/or small are used';
+  return await doTest(
+    page, report, withItems, 'textSem', selector, whats, 0, getBadWhat.toString()
+  );
+};

package/testaro/title.d.ts

@@ -0,0 +1,9 @@
+import type { Page } from 'playwright';
+export declare const reporter: (page: Page) => Promise<{
+    data: {
+        success: boolean;
+        title: string;
+    };
+    totals: never[];
+    standardInstances: never[];
+}>;

package/testaro/title.js

@@ -1,3 +1,4 @@
+"use strict";
 /*
   © 2022–2023 CVS Health and/or one of its affiliates. All rights reserved.
   © 2026 Jonathan Robert Pool.
@@ -6,21 +7,23 @@
 
   SPDX-License-Identifier: MIT
 */
-
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reporter = void 0;
 /*
   title
-  This test reports the page title.
+  This test reports the page title. Compiled to title.js by tsc (issue #73); edit this file,
+  not the emitted one.
 */
-
 // Runs the test and returns the result.
-exports.reporter = async page => {
-  const title = await page.title();
-  return {
-    data: {
-      success: true,
-      title
-    },
-    totals: [],
-    standardInstances: []
-  };
+const reporter = async (page) => {
+    const title = await page.title();
+    return {
+        data: {
+            success: true,
+            title
+        },
+        totals: [],
+        standardInstances: []
+    };
 };
+exports.reporter = reporter;