testaro 8.4.1 → 8.4.3

package/commands.js

@@ -28,7 +28,8 @@ exports.commands = {
       'Launch a Playwright browser',
       {
         which: [true, 'string', 'isBrowserType', '“chromium”, “firefox”, or “webkit”'],
-        what: [false, 'string', 'hasLength', 'comment']
+        what: [false, 'string', 'hasLength', 'comment'],
+        lowMotion: [false, 'boolean', '', 'set reduced-motion option if true']
       }
     ],
     link: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "testaro",
-  "version": "8.4.1",
+  "version": "8.4.3",
   "description": "Automation of accessibility testing",
   "main": "index.js",
   "scripts": {

package/run.js

@@ -294,7 +294,7 @@ const browserClose = async () => {
 // Returns the first line of an error message.
 const errorStart = error => error.message.replace(/\n.+/s, '');
 // Launches a browser.
-const launch = async (report, typeName) => {
+const launch = async (report, typeName, lowMotion = false) => {
   const browserType = require('playwright')[typeName];
   // If the specified browser type exists:
   if (browserType) {
@@ -316,7 +316,9 @@ const launch = async (report, typeName) => {
     });
     // If the launch succeeded:
     if (healthy) {
-      browserContext = await browser.newContext();
+      // Open a context (i.e. browser tab), with reduced motion if specified.
+      const options = {reduceMotion: lowMotion ? 'reduce' : 'no-preference'};
+      browserContext = await browser.newContext(options);
       // When a page (i.e. browser tab) is added to the browser context (i.e. browser window):
       browserContext.on('page', async page => {
         // Make the page current.
@@ -659,7 +661,7 @@ const doActs = async (report, actIndex, page) => {
       // Otherwise, if the command is a launch:
       else if (act.type === 'launch') {
         // Launch the specified browser, creating a browser context and a page in it.
-        await launch(report, act.which);
+        await launch(report, act.which, act.lowMotion ? 'reduce' : 'no-preference');
         // Identify its only page as current.
         page = browserContext.pages()[0];
       }

package/tests/attVal.js

@@ -7,6 +7,7 @@ exports.reporter = async (page, attributeName, areLicit, values, withItems) => {
   const badAttributeData = await page.evaluate(
     args => {
       const attributeName = args[0];
+      // Whether the values are the licit or the illicit ones.
       const areLicit = args[1];
       const values = args[2];
       // Returns the text of an element.
@@ -15,15 +16,17 @@ exports.reporter = async (page, attributeName, areLicit, values, withItems) => {
         text = text.trim() || element.innerHTML;
         return text.replace(/\s+/sg, ' ').replace(/<>&/g, '').slice(0, limit);
       };
+      // Get the elements (including the html element) with the attribute.
       const attributeElements = Array.from(document.querySelectorAll(`[${attributeName}]`));
+      // Get those in which the attribute has an illicit value.
       const badElements = attributeElements
       .filter(el => {
         const value = el.getAttribute(attributeName);
         if (areLicit) {
-          return values.includes(value);
+          return ! values.includes(value);
         }
         else {
-          return ! values.includes(value);
+          return values.includes(value);
         }
       });
       const report = badElements.map(el => ({