testaro 60.16.0 → 60.16.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "testaro",
-  "version": "60.16.0",
+  "version": "60.16.1",
   "description": "Run 1000 web accessibility tests from 11 tools and get a standardized report",
   "main": "index.js",
   "scripts": {

package/testaro/zIndex.js

@@ -1,5 +1,6 @@
 /*
   © 2021–2023 CVS Health and/or one of its affiliates. All rights reserved.
+  © 2025 Jonathan Robert Pool
 
   Licensed under the MIT License. See LICENSE file at the project root or
   https://opensource.org/license/mit/ for details.
@@ -9,42 +10,34 @@
 
 /*
   zIndex
-  This test reports elements with non-auto z indexes. It assumes that pages are most accessible
+  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 control.
+  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.
+  element is covered by another element. Z indexes other than auto and 0 are considered abnormal.
 */
 
-// ########## IMPORTS
+// IMPORTS
 
-// Module to perform common operations.
-const {init, getRuleResult} = require('../procs/testaro');
+const {doTest} = require('../procs/testaro');
 
-// ########## FUNCTIONS
+// FUNCTIONS
 
 // Runs the test and returns the result.
 exports.reporter = async (page, withItems) => {
-  // Initialize the locators and result.
-  const all = await init(100, page, 'body *');
-  // For each locator:
-  for (const loc of all.allLocs) {
-    // Get whether its element violates the rule.
-    const badZ = await loc.evaluate(el => {
-      const styleDec = window.getComputedStyle(el);
-      const {zIndex} = styleDec;
-      return zIndex !== 'auto' ? zIndex : null;
-    });
-    // If it does:
-    if (badZ) {
-      // Add the locator to the array of violators.
-      all.locs.push([loc, badZ]);
+  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}`;
     }
-  }
-  // Populate and return the result.
-  const whats = [
-    'Element has a non-default Z index (__param__)', 'Elements have non-default Z indexes'
-  ];
-  return await getRuleResult(withItems, all, 'zIndex', whats, 0);
+  };
+  const whats = 'Elements have non-default Z indexes';
+  return await doTest(
+    page, withItems, 'zIndex', 'body *', whats, 0, null, getBadWhat.toString()
+  );
 };