testaro 18.3.0 → 18.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "testaro",
-  "version": "18.3.0",
+  "version": "18.4.0",
   "description": "Run 920 web accessibility tests from 9 tools and get a standardized report",
   "main": "index.js",
   "scripts": {

package/testaro/hrRisk.js

@@ -0,0 +1,67 @@
+/*
+  hrRisk
+  Related to ASLint test horizontal-rule.
+  This test reports the existence of hr elements. Their semantics are inconsistently defined and
+  interpreted and impair accessibility compared with stylistic segmentation.
+*/
+
+// ########## IMPORTS
+
+// Module to get locator data.
+const {getLocatorData} = require('../procs/getLocatorData');
+
+// ########## FUNCTIONS
+
+// Performs the test.
+exports.reporter = async (page, withItems) => {
+  // Initialize the standard result.
+  const data = {};
+  const totals = [0, 0, 0, 0];
+  const standardInstances = [];
+  // Get locators for all applicable elements.
+  const locAll = page.locator('body hr');
+  const locsAll = await locAll.all();
+  // For each of them:
+  for (const loc of locsAll) {
+    // Add to the totals.
+    totals[0]++;
+    // If itemization is required:
+    if (withItems) {
+      // Get data on the element.
+      const elData = await getLocatorData(loc);
+      // Add a standard instance.
+      standardInstances.push({
+        ruleID: 'hrRisk',
+        what: 'Element instead of styling is used for vertical segmentation',
+        ordinalSeverity: 0,
+        tagName: 'HR',
+        id: elData.id,
+        location: elData.location,
+        excerpt: elData.excerpt
+      });
+    }
+  }
+  // If itemization is not required and there are instances:
+  if (! withItems && totals[0]) {
+    // Add a summary instance.
+    standardInstances.push({
+      ruleID: 'hrRisk',
+      what: 'Elements instead of styling are used for vertical segmentation',
+      ordinalSeverity: 0,
+      count: totals[0],
+      tagName: 'HR',
+      id: '',
+      location: {
+        doc: '',
+        type: '',
+        spec: ''
+      },
+      excerpt: ''
+    });
+  }
+  return {
+    data,
+    totals,
+    standardInstances
+  };
+};

package/tests/testaro.js

@@ -25,6 +25,7 @@ const evalRules = {
   headingAmb: 'same-level sibling headings with identical texts',
   hover: 'hover-caused content changes',
   hovInd: 'hover indication nonstandard',
+  hrRisk: 'hr element instead of styles used for vertical segmentation',
   labClash: 'labeling inconsistencies',
   lineHeight: 'text with a line height less than 1.5 times its font size',
   linkExt: 'links that automatically open new windows',

package/validation/tests/jobs/hrRisk.json

@@ -0,0 +1,134 @@
+{
+  "id": "hrRisk",
+  "what": "validation of hrRisk test",
+  "strict": true,
+  "timeLimit": 20,
+  "acts": [
+    {
+      "type": "launch",
+      "which": "chromium",
+      "what": "usual browser"
+    },
+    {
+      "type": "url",
+      "which": "__targets__/hrRisk/index.html",
+      "what": "page with an hr element"
+    },
+    {
+      "type": "test",
+      "which": "testaro",
+      "withItems": true,
+      "stopOnFail": true,
+      "expect": [
+        [
+          "standardResult.totals.0",
+          "=",
+          1
+        ],
+        [
+          "standardResult.totals.1",
+          "=",
+          0
+        ],
+        [
+          "standardResult.instances.0.ruleID",
+          "=",
+          "hrRisk"
+        ],
+        [
+          "standardResult.instances.0.what",
+          "i",
+          "Element instead"
+        ],
+        [
+          "standardResult.instances.0.ordinalSeverity",
+          "=",
+          0
+        ],
+        [
+          "standardResult.instances.0.tagName",
+          "=",
+          "HR"
+        ],
+        [
+          "standardResult.instances.0.location.doc",
+          "=",
+          "dom"
+        ],
+        [
+          "standardResult.instances.0.location.type",
+          "=",
+          "box"
+        ],
+        [
+          "standardResult.instances.0.location.spec.y",
+          ">",
+          0
+        ],
+        [
+          "standardResult.instances.0.excerpt",
+          "i",
+          "hr"
+        ]
+      ],
+      "rules": [
+        "y",
+        "hrRisk"
+      ]
+    },
+    {
+      "type": "test",
+      "which": "testaro",
+      "withItems": false,
+      "stopOnFail": true,
+      "expect": [
+        [
+          "standardResult.totals.0",
+          "=",
+          1
+        ],
+        [
+          "standardResult.totals.2",
+          "=",
+          0
+        ],
+        [
+          "standardResult.instances.length",
+          "=",
+          1
+        ],
+        [
+          "standardResult.instances.0.ruleID",
+          "=",
+          "hrRisk"
+        ],
+        [
+          "standardResult.instances.0.what",
+          "i",
+          "Elements instead"
+        ],
+        [
+          "standardResult.instances.0.ordinalSeverity",
+          "=",
+          0
+        ],
+        [
+          "standardResult.instances.0.tagName",
+          "=",
+          "HR"
+        ]
+      ],
+      "rules": [
+        "y",
+        "hrRisk"
+      ]
+    }
+  ],
+  "sources": {
+    "script": "",
+    "host": {},
+    "requester": ""
+  },
+  "creationTime": "2013-05-28T12:00:00",
+  "timeStamp": "00000"
+}

package/validation/tests/targets/hrRisk/index.html

@@ -0,0 +1,18 @@
+<!DOCTYPE html>
+<html lang="en-US">
+  <head>
+    <meta charset="utf-8">
+    <title>Page with an hr element</title>
+    <meta name="description" content="tester">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+  </head>
+  <body>
+    <main>
+      <h1>Page with an hr element</h1>
+      <p>This is the start of the main text.</p>
+      <p>This is the end of the main text.</p>
+      <hr>
+      <p>This is the postscript to the main text.</p>
+    </main>
+  </body>
+</html>