testaro 78.0.8 → 78.4.0

package/testaro/title.ts

@@ -0,0 +1,31 @@
+/*
+  © 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.
+
+  SPDX-License-Identifier: MIT
+*/
+
+// IMPORTS
+
+import type {Page} from 'playwright';
+
+/*
+  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.
+export const reporter = async (page: Page) => {
+  const title = await page.title();
+  return {
+    data: {
+      success: true,
+      title
+    },
+    totals: [],
+    standardInstances: []
+  };
+};

package/testaro/titledEl.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/titledEl.js

@@ -1,3 +1,4 @@
+"use strict";
 /*
   © 2023–2025 CVS Health and/or one of its affiliates. All rights reserved.
   © 2026 Jeff Witt.
@@ -8,28 +9,24 @@
 
   SPDX-License-Identifier: MIT
 */
-
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reporter = void 0;
+const testaro_1 = require("../procs/testaro");
 /*
   titledEl
   This test reports suspicious use of title attributes.
+  Compiled to titledEl.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 elementType = element.tagName.toLowerCase();
-    // Return a violation description.
-    return `Likely ineffective title attribute is used on the ${elementType} element`;
-  }
-  const selector = 'body [title]:not(iframe, link, style)';
-  const whats = 'title attributes are used on elements they are likely ineffective on';
-  return await doTest(
-    page, report, withItems, 'titledEl', selector, whats, 0, getBadWhat.toString()
-  );
+const reporter = async (page, report, _, withItems) => {
+    const getBadWhat = element => {
+        const elementType = element.tagName.toLowerCase();
+        // Return a violation description.
+        return `Likely ineffective title attribute is used on the ${elementType} element`;
+    };
+    const selector = 'body [title]:not(iframe, link, style)';
+    const whats = 'title attributes are used on elements they are likely ineffective on';
+    return await (0, testaro_1.doTest)(page, report, withItems, 'titledEl', selector, whats, 0, getBadWhat.toString());
 };
+exports.reporter = reporter;

package/testaro/titledEl.ts

@@ -0,0 +1,38 @@
+/*
+  © 2023–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';
+
+/*
+  titledEl
+  This test reports suspicious use of title attributes.
+  Compiled to titledEl.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 elementType = element.tagName.toLowerCase();
+    // Return a violation description.
+    return `Likely ineffective title attribute is used on the ${elementType} element`;
+  }
+  const selector = 'body [title]:not(iframe, link, style)';
+  const whats = 'title attributes are used on elements they are likely ineffective on';
+  return await doTest(
+    page, report, withItems, 'titledEl', selector, whats, 0, getBadWhat.toString()
+  );
+};

package/testaro/zIndex.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/zIndex.js

@@ -1,3 +1,4 @@
+"use strict";
 /*
   © 2021–2023 CVS Health and/or one of its affiliates. All rights reserved.
   © 2026 Jeff Witt.
@@ -8,32 +9,28 @@
 
   SPDX-License-Identifier: MIT
 */
-
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reporter = void 0;
+const testaro_1 = require("../procs/testaro");
 /*
   zIndex
   This test reports elements with abnormal Z indexes. It assumes that pages are most accessible when they do not require users to perceive a third dimension (depth). Layers, popups, and dialogs that cover other content make it difficult for some or all users to interpret the content and know what parts of the content can be acted on. Layering also complicates accessibility testing. Tests for visibility of focus, for example, may fail if incapable of detecting that a focused element is covered by another element. Z indexes other than auto and 0 are considered abnormal.
+  Compiled to zIndex.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 => {
-    // Get whether the element violates the rule.
-    const styleDec = window.getComputedStyle(element);
-    const {zIndex} = styleDec;
-    // If the Z index of the element is neither 'auto' nor 0:
-    if (! ['auto', '0'].includes(zIndex)) {
-      // Return a violation description.
-      return `z-index style property of the element is ${zIndex}`;
-    }
-  };
-  const whats = 'Elements have non-default Z indexes';
-  return await doTest(
-    page, report, withItems, 'zIndex', 'body, body *', whats, 0, getBadWhat.toString()
-  );
+const reporter = async (page, report, _, withItems) => {
+    const getBadWhat = element => {
+        // Get whether the element violates the rule.
+        const styleDec = window.getComputedStyle(element);
+        const { zIndex } = styleDec;
+        // If the Z index of the element is neither 'auto' nor 0:
+        if (!['auto', '0'].includes(zIndex)) {
+            // Return a violation description.
+            return `z-index style property of the element is ${zIndex}`;
+        }
+    };
+    const whats = 'Elements have non-default Z indexes';
+    return await (0, testaro_1.doTest)(page, report, withItems, 'zIndex', 'body, body *', whats, 0, getBadWhat.toString());
 };
+exports.reporter = reporter;

package/testaro/zIndex.ts

@@ -0,0 +1,42 @@
+/*
+  © 2021–2023 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';
+
+/*
+  zIndex
+  This test reports elements with abnormal Z indexes. It assumes that pages are most accessible when they do not require users to perceive a third dimension (depth). Layers, popups, and dialogs that cover other content make it difficult for some or all users to interpret the content and know what parts of the content can be acted on. Layering also complicates accessibility testing. Tests for visibility of focus, for example, may fail if incapable of detecting that a focused element is covered by another element. Z indexes other than auto and 0 are considered abnormal.
+  Compiled to zIndex.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 => {
+    // Get whether the element violates the rule.
+    const styleDec = window.getComputedStyle(element);
+    const {zIndex} = styleDec;
+    // If the Z index of the element is neither 'auto' nor 0:
+    if (! ['auto', '0'].includes(zIndex)) {
+      // Return a violation description.
+      return `z-index style property of the element is ${zIndex}`;
+    }
+  };
+  const whats = 'Elements have non-default Z indexes';
+  return await doTest(
+    page, report, withItems, 'zIndex', 'body, body *', whats, 0, getBadWhat.toString()
+  );
+};

package/tests/alfa.d.ts

@@ -0,0 +1,45 @@
+import type { Page } from 'playwright';
+import type { Report, StandardResult } from '../types';
+interface AlfaEvalItem {
+    diagnostic?: {
+        errors?: {
+            element?: unknown;
+            positionedDescendants?: unknown;
+        }[];
+    };
+    expectations?: {
+        error?: {
+            message?: string;
+        };
+    }[][];
+    outcome: string;
+    rule: {
+        requirements?: {
+            title?: string;
+        }[];
+        uri: string;
+    };
+    target?: {
+        children?: unknown;
+    };
+    code?: string;
+    path?: string;
+}
+interface AlfaNativeResult {
+    totals: {
+        failed: number;
+        cantTell: number;
+    };
+    items: AlfaEvalItem[];
+}
+export declare const reporter: (page: Page, report: Report, actIndex: number) => Promise<{
+    data: {
+        prevented?: boolean;
+        error?: string;
+    };
+    result: {
+        nativeResult: AlfaNativeResult;
+        standardResult: StandardResult;
+    };
+}>;
+export {};

package/tests/alfa.js

@@ -1,3 +1,4 @@
+"use strict";
 /*
   © 2021–2024 CVS Health and/or one of its affiliates. All rights reserved.
   © 2026 Jeff Witt.
@@ -8,159 +9,155 @@
 
   SPDX-License-Identifier: MIT
 */
-
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reporter = void 0;
+const xPath_1 = require("../procs/xPath");
+const standard_1 = require("../procs/standard");
+const config_1 = require("../procs/config");
+/*
+  The alfa packages are pure ESM that Node loads via require(esm); their own
+  types do not resolve under this project's node10 module resolution, so the
+  imports stay requires and are untyped.
+*/
+let alfaRules = require('@siteimprove/alfa-rules').default;
+const { Audit } = require('@siteimprove/alfa-act');
+const { Playwright } = require('@siteimprove/alfa-playwright');
 /*
   alfa
   Implements the alfa ruleset for accessibility.
+  Compiled to alfa.js by tsc (issue #73); edit this file, not the emitted one.
 */
-
-// IMPORTS
-
-let alfaRules = require('@siteimprove/alfa-rules').default;
-const {Audit} = require('@siteimprove/alfa-act');
-const {getNormalizedXPath, getXPathCatalogIndex} = require('../procs/xPath');
-const {Playwright} = require('@siteimprove/alfa-playwright');
-const {applyMultiplier} = require('../procs/config');
-
 // FUNCTIONS
-
 // Conducts and reports the alfa tests.
-exports.reporter = async (page, report, actIndex) => {
-  const act = report.acts[actIndex];
-  const {rules} = act;
-  // If only some rules are to be employed:
-  if (rules && rules.length) {
-    // Remove the other rules.
-    alfaRules = alfaRules.filter(rule => rules.includes(rule.uri.replace(/^.+-/, '')));
-  }
-  // Initialize the act report.
-  const data = {};
-  const result = {
-    nativeResult: {
-      totals: {
-        failed: 0,
-        cantTell: 0
-      },
-      items: []
-    },
-    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 reporter = async (page, report, actIndex) => {
+    const act = report.acts[actIndex];
+    const { rules } = act;
+    // If only some rules are to be employed:
+    if (rules && rules.length) {
+        // Remove the other rules.
+        alfaRules = alfaRules.filter((rule) => rules.includes(rule.uri.replace(/^.+-/, '')));
+    }
+    // Initialize the act report.
+    const data = {};
+    const result = {
+        nativeResult: {
+            totals: {
+                failed: 0,
+                cantTell: 0
+            },
+            items: []
+        },
+        standardResult: {}
     };
-  }
-  try {
+    const standard = report.standard !== 'no';
+    // If standard results are to be reported:
+    if (standard) {
+        // Initialize the standard result.
+        result.standardResult = (0, standard_1.getStandardResult)();
+    }
     try {
-      // Wait for a stable page to make the page and its alfa version consistent.
-      await page.waitForLoadState('networkidle', {timeout: applyMultiplier(9000)});
+        try {
+            // Wait for a stable page to make the page and its alfa version consistent.
+            await page.waitForLoadState('networkidle', { timeout: (0, config_1.applyMultiplier)(9000) });
+        }
+        // If that fails:
+        catch (error) {
+            // Wait for the page to be loaded.
+            await page.waitForLoadState('domcontentloaded', { timeout: (0, config_1.applyMultiplier)(6000) });
+        }
+        const doc = await page.evaluateHandle('document');
+        const alfaPage = await Playwright.toPage(doc);
+        // Test the page content with the specified rules.
+        const audit = Audit.of(alfaPage, alfaRules);
+        // Get the evaluations.
+        const evaluations = Array.from(await audit.evaluate());
+        const { nativeResult, standardResult } = result;
+        // For each of them:
+        for (const index in evaluations) {
+            const evaluation = evaluations[index];
+            const targetClass = evaluation.target;
+            // If it has a non-collection violator:
+            if (targetClass && !targetClass._members) {
+                // Convert the evaluation to an element-specific item.
+                const item = evaluation.toJSON();
+                const { diagnostic, expectations, outcome, rule, target } = item;
+                // If the outcome of the item is a failure or warning:
+                if (['failed', 'cantTell'].includes(outcome)) {
+                    // Delete typically massive properties unlikely to be useful.
+                    delete target.children;
+                    if (diagnostic?.errors) {
+                        diagnostic.errors.forEach(error => {
+                            delete error.element;
+                            delete error.positionedDescendants;
+                        });
+                    }
+                    // Increment the applicable total.
+                    nativeResult.totals[outcome]++;
+                    const codeLines = targetClass.toString().split('\n');
+                    if (codeLines[0] === '#document') {
+                        codeLines.splice(2, codeLines.length - 3, ' … ');
+                    }
+                    else if (codeLines[0].startsWith('<html')) {
+                        codeLines.splice(1, codeLines.length - 2, ' … ');
+                    }
+                    let code = codeLines.join('/n');
+                    if (code.length > 400) {
+                        code = `${code.slice(0, 300)} … ${code.slice(-100)}`;
+                    }
+                    // Add properties of the evaluation to the item.
+                    item.code = code;
+                    item.path = targetClass.path();
+                    // Add the item to the items of the native result.
+                    nativeResult.items.push(item);
+                    // If standard results are to be reported:
+                    if (standard) {
+                        const { requirements, uri } = rule;
+                        // Get the rule ID of the item.
+                        const ruleID = uri.replace(/^.+-/, '');
+                        // Get the rule description of the item.
+                        let what = (expectations?.[0]?.[1]?.error?.message || '').trim().replace(/\s+/g, ' ');
+                        if (!what) {
+                            if (requirements && requirements.length && requirements[0].title) {
+                                what = requirements[0].title;
+                            }
+                        }
+                        // An untestable item keeps its rule ID; its outcome records the uncertainty. The
+                        // contrast rules (r66, r69) cannot tell when a background needs human judgement.
+                        const isCantTell = outcome === 'cantTell';
+                        const xPath = (0, xPath_1.getNormalizedXPath)(item.path?.replace(/\/text\(\).*$/, '') || '/html');
+                        // Add an instance to the standard instances.
+                        (0, standard_1.addInstance)(standardResult, {
+                            ruleID,
+                            what,
+                            ordinalSeverity: isCantTell ? 0 : 2,
+                            outcome: isCantTell ? 'cantTell' : 'failed',
+                            uncertainty: isCantTell && ['r66', 'r69'].includes(ruleID)
+                                ? 'judgement-required'
+                                : undefined,
+                            catalogIndex: (0, xPath_1.getXPathCatalogIndex)(report, xPath)
+                        });
+                    }
+                }
+            }
+        }
+        ;
     }
-    // If that fails:
     catch (error) {
-      // Wait for the page to be loaded.
-      await page.waitForLoadState('domcontentloaded', {timeout: applyMultiplier(6000)});
-    }
-    const doc = await page.evaluateHandle('document');
-    const alfaPage = await Playwright.toPage(doc);
-    // Test the page content with the specified rules.
-    const audit = Audit.of(alfaPage, alfaRules);
-    // Get the evaluations.
-    const evaluations = Array.from(await audit.evaluate());
-    const {nativeResult, standardResult} = result;
-    // For each of them:
-    for (const index in evaluations) {
-      const evaluation = evaluations[index];
-      const targetClass = evaluation.target;
-      // If it has a non-collection violator:
-      if (targetClass && ! targetClass._members) {
-        // Convert the evaluation to an element-specific item.
-        const item = evaluation.toJSON();
-        const {diagnostic, expectations, outcome, rule, target} = item;
-        // If the outcome of the item is a failure or warning:
-        if (['failed', 'cantTell'].includes(outcome)) {
-          // Delete typically massive properties unlikely to be useful.
-          delete target.children;
-          if (diagnostic?.errors) {
-            diagnostic.errors.forEach(error => {
-              delete error.element;
-              delete error.positionedDescendants;
-            });
-          }
-          // Increment the applicable total.
-          nativeResult.totals[outcome]++;
-          const codeLines = targetClass.toString().split('\n');
-          if (codeLines[0] === '#document') {
-            codeLines.splice(2, codeLines.length - 3, ' … ');
-          }
-          else if (codeLines[0].startsWith('<html')) {
-            codeLines.splice(1, codeLines.length - 2, ' … ');
-          }
-          let code = codeLines.join('/n');
-          if (code.length > 400) {
-            code = `${code.slice(0, 300)} … ${code.slice(-100)}`;
-          }
-          // Add properties of the evaluation to the item.
-          item.code = code;
-          item.path = targetClass.path();
-          // Add the item to the items of the native result.
-          nativeResult.items.push(item);
-          // If standard results are to be reported:
-          if (standard) {
-            const {requirements, uri} = rule;
-            // Get the rule ID of the item.
-            let ruleID = uri.replace(/^.+-/, '');
-            // Get the rule description of the item.
-            let what = (expectations?.[0]?.[1]?.error?.message || '').trim().replace(/\s+/g, ' ');
-            if (! what) {
-              if (requirements && requirements.length && requirements[0].title) {
-                what = requirements[0].title;
-              }
+        data.prevented = true;
+        const { message } = error;
+        if (message) {
+            if (message.includes('Unsupported node of type: 4')) {
+                data.error = 'Alfa cannot test page because it contains CDATA';
             }
-            // Get the ordinal severity of the item.
-            let ordinalSeverity = 2;
-            // If the outcome is untestability:
-            if (outcome === 'cantTell') {
-              // Revise the rule-specific properties.
-              ruleID = ['r66', 'r69'].includes(ruleID) ? 'cantTell' : 'cantTellTextContrast';
-              what = `cannot test for rule ${ruleID}: ${what}`;
-              ordinalSeverity = 0;
+            else {
+                data.error = message;
             }
-            // Increment the standard total.
-            standardResult.totals[ordinalSeverity]++;
-            const xPath = getNormalizedXPath(item.path?.replace(/\/text\(\).*$/, '') || '/html');
-            // Add an instance to the standard instances.
-            standardResult.instances.push({
-              ruleID,
-              what,
-              ordinalSeverity,
-              count: 1,
-              catalogIndex: getXPathCatalogIndex(report, xPath)
-            });
-          }
         }
-      }
-    };
-  }
-  catch(error) {
-    data.prevented = true;
-    const {message} = error;
-    if (message) {
-      if (message.includes('Unsupported node of type: 4')) {
-        data.error = 'Alfa cannot test page because it contains CDATA';
-      }
-      else {
-        data.error = message;
-      }
+        console.log(`ERROR: ${data.error}`);
     }
-    console.log(`ERROR: ${data.error}`);
-  }
-  return {
-    data,
-    result
-  };
+    return {
+        data,
+        result
+    };
 };
+exports.reporter = reporter;