testaro 65.1.1 → 66.0.1

package/README.md

@@ -48,7 +48,7 @@ Testaro uses:
 - [Playwright](https://playwright.dev/) to launch browsers, perform user actions in them, and perform tests
 - [playwright-extra](https://www.npmjs.com/package/playwright-extra) and [puppeteer-extra-plugin-stealth](https://www.npmjs.com/package/puppeteer-extra-plugin-stealth) to make a Playwright-controlled browser more indistinguishable from a human-operated browser and thus make their requests more likely to succeed
 - [playwright-dompath](https://www.npmjs.com/package/playwright-dompath) to retrieve XPaths of elements
-- [pixelmatch](https://www.npmjs.com/package/pixelmatch) to measure motion
+- [BlazeDiff](https://blazediff.dev/) to measure motion
 
 Testaro performs tests of these _tools_:
 

package/UPGRADES.md

@@ -54,7 +54,7 @@ I'll quickly scan for module patterns and JSON imports across the repo to tailor
   - Strategy for optional properties and progressive enrichment during execution.
 
 - **3rd‑party types and augmentations**
-  - Verify/choose type packages for `playwright`, `@siteimprove/alfa-*`, `axe-playwright`, `@qualweb/*`, `accessibility-checker`, `playwright-dompath`, `pixelmatch`. Plan fallbacks if defs are missing.
+  - Verify/choose type packages for `playwright`, `@siteimprove/alfa-*`, `axe-playwright`, `@qualweb/*`, `accessibility-checker`, `playwright-dompath`. Plan fallbacks if defs are missing.
   - Decide on module augmentation vs casting for custom fields (e.g., `page.browserID` assignment requires augmenting `playwright.Page` or casting).
 
 - **Dynamic loading patterns**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "testaro",
-  "version": "65.1.1",
+  "version": "66.0.1",
   "description": "Run 1000 web accessibility tests from 11 tools and get a standardized report",
   "main": "index.js",
   "scripts": {
@@ -30,6 +30,7 @@
   },
   "homepage": "https://github.com/jrpool/testaro#readme",
   "dependencies": {
+    "@blazediff/core": "*",
     "@qualweb/core": "*",
     "@qualweb/act-rules": "*",
     "@qualweb/wcag-techniques": "*",
@@ -43,11 +44,11 @@
     "aslint-testaro": "*",
     "axe-playwright": "*",
     "dotenv": "*",
-    "pixelmatch": "*",
     "playwright": "*",
     "playwright-dompath": "*",
     "playwright-extra": "*",
     "playwright-extra-plugin-stealth": "*",
+    "pngjs": "*",
     "puppeteer-extra-plugin-stealth": "*",
     "vnu-jar": "*"
   },

package/testaro/motion.js

@@ -19,7 +19,7 @@ const fs = require('fs/promises');
 // Module to get operating-system properties.
 const os = require('os');
 // Module to compare screenshots.
-const pixelmatch = require('pixelmatch').default;
+const blazediff = require('@blazediff/core').diff;
 // Module to parse PNGs.
 const {PNG} = require('pngjs');
 
@@ -60,7 +60,7 @@ exports.reporter = async page => {
       // Otherwise, i.e. if their dimensions are identical:
       else {
         // Get the count of differing pixels between the shots.
-        const pixelChanges = pixelmatch(shoot0PNG.data, shoot1PNG.data, null, width, height);
+        const pixelChanges = blazediff(shoot0PNG.data, shoot1PNG.data, null, width, height);
         // Get the ratio of differing to all pixels as a percentage.
         const changePercent = Math.round(100 * pixelChanges / (width * height));
         // Free the memory used by screenshots.

package/tests/testaro.js

@@ -393,13 +393,6 @@ const allRules = [
     timeOut: 10,
     defaultOn: true
   },
-  {
-    id: 'motionSolo',
-    what: 'motion without user request, measured within this test',
-    launchRole: 'waster',
-    timeOut: 15,
-    defaultOn: false
-  },
   {
     id: 'textNodes',
     what: 'data on specified text nodes',

package/procs/visChange.js

@@ -1,103 +0,0 @@
-/*
-  © 2023–2025 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.
-
-  SPDX-License-Identifier: MIT
-*/
-
-/*
-  visChange
-  This procedure reports a change in the visible content of a page between two times, optionally
-  hovering over a locator-defined element immediately after the first time. This test uses the
-  Playwright page.screenshot method, which is not implemented for the firefox browser type.
-*/
-
-// IMPORTS
-
-const pixelmatch = require('pixelmatch').default;
-const {PNG} = require('pngjs');
-const {screenShot} = require('./screenShot');
-
-// FUNCTIONS
-
-exports.visChange = async (page, options = {}) => {
-  const {delayBefore, delayBetween, exclusion} = options;
-  // Wait, if required.
-  if (delayBefore) {
-    await page.waitForTimeout(delayBefore);
-  }
-  // If an exclusion was specified:
-  if (exclusion) {
-    // Hover over the upper-left corner of the page for test isolation.
-    const docLoc = page.locator('html');
-    await docLoc.hover({
-      position: {
-        x: 0,
-        y: 0
-      }
-    });
-  }
-  // Make and get a screenshot, excluding an element if specified.
-  const shot0 = await screenShot(page, exclusion);
-  // If it succeeded:
-  if (shot0.length) {
-    // If an exclusion was specified:
-    if (exclusion) {
-      // Hover over it.
-      try {
-        await exclusion.hover({
-          timeout: 500,
-          noWaitAfter: true
-        });
-      }
-      catch(error) {
-        return {
-          prevented: true,
-          error: 'Hovering failed'
-        };
-      }
-    }
-    // Wait as specified, or 3 seconds.
-    await page.waitForTimeout(delayBetween || 3000);
-    // Make and get another screenshot.
-    const shot1 = await screenShot(page, exclusion);
-    // If it succeeded:
-    if (shot1.length) {
-      // Get the shots as PNG images.
-      const pngs = [shot0, shot1].map(shot => PNG.sync.read(shot));
-      // Get their dimensions.
-      const {width, height} = pngs[0];
-      // Get the count of differing pixels between the shots.
-      const pixelChanges = pixelmatch(pngs[0].data, pngs[1].data, null, width, height);
-      // Get the ratio of differing to all pixels as a percentage.
-      const changePercent = 100 * pixelChanges / (width * height);
-      // Return this.
-      return {
-        prevented: false,
-        width,
-        height,
-        pixelChanges,
-        changePercent
-      };
-    }
-    // Otherwise, i.e. if the second screenshot failed:
-    else {
-      // Return this.
-      return {
-        prevented: true,
-        error: 'Second screenshot failed'
-      };
-    }
-  }
-  // Otherwise, i.e. if the first screenshot failed:
-  else {
-    // Return this.
-    return {
-      prevented: true,
-      error: 'First screenshot failed'
-    };
-  }
-};

package/testaro/motionSolo.js

@@ -1,68 +0,0 @@
-/*
-  © 2021–2024 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.
-
-  SPDX-License-Identifier: MIT
-*/
-
-/*
-  motion
-  This test reports motion in a page. For minimal accessibility, standards require motion to be brief, or else stoppable by the user. But stopping motion can be difficult or impossible, and, by the time a user manages to stop motion, the motion may have caused annoyance or harm. For superior accessibility, a page contains no motion until and unless the user authorizes it. The test compares two screen shots of the viewport 2 seconds and 6 seconds after page load. It reports a rule violation if any pixels change. The larger the change fraction, the greater the ordinal severity.
-
-  This test is an alternative to the motion test. Whereas the motion test relies on screenshots made earlier in the same job by the shoot test, this test makes its own screenshots. MotionSolo waits several seconds between its screenshots to allow time for motion to occur. That wait makes motionSolo, and any job containing it, take longer than the combination of shoot tests and the motion test.
-
-  WARNING: This test uses the procs/visChange module. See the warning in that module about browser types.
-*/
-
-// IMPORTS
-
-// Module to get pixel changes between two times.
-const {visChange} = require('../procs/visChange');
-
-// FUNCTIONS
-
-// Reports motion in a page.
-exports.reporter = async page => {
-  // Initialize the totals and standard instances.
-  const totals = [0, 0, 0, 0];
-  const standardInstances = [];
-  // Make screenshots and get the result.
-  const data = await visChange(page, {
-    delayBefore: 2000,
-    delayBetween: 3000
-  });
-  // If the screenshots succeeded:
-  if (! data.prevented) {
-    // If any pixels were changed:
-    if (data.pixelChanges) {
-      // Get the ordinal severity from the fractional pixel change.
-      const ordinalSeverity = Math.floor(Math.min(3, 0.4 * Math.sqrt(data.changePercent)));
-      // Add to the totals.
-      totals[ordinalSeverity] = 1;
-      // Get a summary standard instance.
-      standardInstances.push({
-        ruleID: 'motionSolo',
-        what: 'Content moves or changes without user request',
-        count: 1,
-        ordinalSeverity,
-        tagName: 'HTML',
-        id: '',
-        location: {
-          doc: '',
-          type: '',
-          spec: ''
-        },
-        excerpt: ''
-      });
-    }
-  }
-  // Return the result.
-  return {
-    data,
-    totals,
-    standardInstances
-  };
-};