testaro 8.2.0 → 8.4.0

package/README.md

@@ -53,8 +53,8 @@ As of this version, the counts of tests in the packages referenced above were:
 - WAVE: 110
 - Nu Html Checker: 147
 - subtotal: 1206
-- Testaro tests: 23
-- grand total: 1229
+- Testaro tests: 24
+- grand total: 1230
 
 ## Quasi-tests
 

package/commands.js

@@ -152,6 +152,15 @@ exports.commands = {
     ]
   },
   tests: {
+    attVal: [
+      'Perform an attVal test',
+      {
+        attributeName: [true, 'string', 'hasLength', 'name of attribute'],
+        areLicit: [true, 'boolean', '', 'whether values are licit'],
+        values: [true, 'array', 'areStrings', 'values of attribute'],
+        withItems: [true, 'boolean', '', 'itemize']
+      }
+    ],
     axe: [
       'Perform an Axe test',
       {

package/package.json

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

package/run.js

@@ -32,6 +32,7 @@ const moves = {
 const tests = {
   alfa: 'alfa',
   allHidden: 'page that is entirely or mostly hidden',
+  attVal: 'elements with attributes having illicit values',
   axe: 'Axe',
   bulk: 'count of visible elements',
   continuum: 'Level Access Continuum, community edition',

package/tests/attVal.js

@@ -0,0 +1,45 @@
+/*
+  attVal
+  This test reports attributes with illicit values.
+*/
+exports.reporter = async (page, attributeName, areLicit, values, withItems) => {
+  // Identify the elements that have the specified attribute with illicit values.
+  const badAttributeData = await page.evaluate(
+    args => {
+      const attributeName = args[0];
+      const areLicit = args[1];
+      const values = args[2];
+      // Returns the text of an element.
+      const textOf = async (element, limit) => {
+        let text = element.textContent;
+        text = text.trim() || element.innerHTML;
+        return text.replace(/\s+/sg, ' ').replace(/<>&/g, '').slice(0, limit);
+      };
+      const attributeElements = Array.from(document.body.querySelectorAll(`[${attributeName}]`));
+      const badElements = attributeElements
+      .filter(el => {
+        const value = el.getAttribute(attributeName);
+        if (areLicit) {
+          return values.includes(value);
+        }
+        else {
+          return ! values.includes(value);
+        }
+      });
+      const report = badElements.map(el => ({
+        tagName: el.tagName,
+        textStart: textOf(el, 70),
+        attributeValue: el.getAttribute(attributeName)
+      }));
+      return report;
+    },
+    [attributeName, areLicit, values]
+  );
+  const data = {
+    total: badAttributeData.length
+  };
+  if (withItems) {
+    data.items = badAttributeData;
+  }
+  return {result: data};
+};