testaro 12.2.7 → 12.3.2

package/actSpecs.js

@@ -168,6 +168,12 @@ exports.actSpecs = {
         withItems: [true, 'boolean', '', 'itemize']
       }
     ],
+    autocomplete: [
+      'Perform an autocomplete test',
+      {
+        withItems: [true, 'boolean', '', 'itemize']
+      }
+    ],
     axe: [
       'Perform an Axe test',
       {

package/package.json

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

package/run.js

@@ -34,6 +34,7 @@ const tests = {
   alfa: 'alfa',
   allHidden: 'page that is entirely or mostly hidden',
   attVal: 'elements with attributes having illicit values',
+  autocomplete: 'name and email inputs without autocomplete attributes',
   axe: 'Axe',
   bulk: 'count of visible elements',
   continuum: 'Level Access Continuum, community edition',
@@ -264,8 +265,9 @@ const isValidReport = report => {
     if (! acts[1].which || typeof acts[1].which !== 'string' || ! isURL(acts[1].which)) {
       return 'Second act which not a URL';
     }
-    if (acts.some(act => ! isValidAct(act))) {
-      return 'Not all acts valid';
+    const invalidAct = acts.find(act => ! isValidAct(act));
+    if (invalidAct) {
+      return `Invalid act:\n${JSON.stringify(invalidAct, null, 2)}`;
     }
     if (! sources || typeof sources !== 'object') {
       return 'Bad report sources';

package/tests/autocomplete.js

@@ -0,0 +1,75 @@
+/*
+  autocomplete
+  This test reports failures to equip name and email inputs with correct autocomplete attributes.
+*/
+
+// ########## IMPORTS
+
+// Returns text associated with an element.
+const {allText} = require('../procs/allText');
+
+// ########## FUNCTIONS
+
+// Adds a failure, if any, to the data.
+const addFailure = async (withItems, input, inputText, autocomplete, data) => {
+  // If it does not have the required autocomplete attribute:
+  const autoValue = await input.getAttribute('autocomplete');
+  if (autoValue !== autocomplete) {
+    // Add this to the total.
+    data.total++;
+    // If itemization is required:
+    if (withItems) {
+      // Add the item to the data.
+      data.items.push([autocomplete, inputText.slice(0, 100)]);
+    }
+  }
+};
+// Reports failures.
+exports.reporter = async (page, withItems) => {
+  const data = {total: 0};
+  if (withItems) {
+    data.items = [];
+  }
+  // Identify the inputs.
+  const inputs = await page.$$('input');
+  // If there are any:
+  if (inputs.length) {
+    // For each one:
+    for (const input of inputs) {
+      const inputText = await allText(page, input);
+      // If it is a text input:
+      const inputType = await input.getAttribute('type');
+      if (inputType === 'text' || ! inputType) {
+        const inputTextLC = inputText.toLowerCase();
+        // If it requests a given name:
+        if (
+          inputTextLC === 'first'
+          || ['first name', 'given name'].some(phrase => inputTextLC.includes(phrase))
+        ) {
+          // Add any failure to the data.
+          await addFailure(withItems, input, inputText, 'given-name', data);
+        }
+        // Otherwise, if it requests a family name:
+        else if (
+          inputTextLC === 'last'
+          || ['last name', 'family name'].some(phrase => inputTextLC.includes(phrase))
+        ) {
+          // Add any failure to the data.
+          await addFailure(withItems, input, inputText, 'family-name', data);
+        }
+        // Otherwise, if it requests an email address:
+        else if (inputTextLC.includes('email')) {
+          // Add any failure to the data.
+          await addFailure(withItems, input, inputText, 'email', data);
+        }
+      }
+      // Otherwise, if it is an email input:
+      else if (inputType === 'email') {
+        // Add any failure to the data.
+        await addFailure(withItems, input, inputText, 'email', data);
+      }
+    }
+  }
+  // Return the data.
+  return {result: data};
+};

package/validation/tests/jobs/autocomplete.json

@@ -0,0 +1,51 @@
+{
+  "id": "autocompleteVal",
+  "what": "validation of autocomplete test",
+  "strict": true,
+  "timeLimit": 20,
+  "acts": [
+    {
+      "type": "launch",
+      "which": "chromium",
+      "what": "usual browser"
+    },
+    {
+      "type": "url",
+      "which": "__targets__/autocomplete/good.html",
+      "what": "page with correct autocomplete attributes"
+    },
+    {
+      "type": "test",
+      "which": "autocomplete",
+      "what": "autocomplete attributes for name and email",
+      "withItems": true,
+      "expect": [
+        ["totals", "=", 0],
+        ["items.1"]
+      ]
+    },
+    {
+      "type": "url",
+      "which": "__targets__/autocomplete/bad.html",
+      "what": "page with incorrect autocomplete attributes"
+    },
+    {
+      "type": "test",
+      "which": "autocomplete",
+      "what": "autocomplete attributes for name and email",
+      "withItems": true,
+      "expect": [
+        ["totals", "=", 4],
+        ["items.1.0", "=", "family-name"],
+        ["items.2.1", "=", "Your email address"]
+      ]
+    }
+  ],
+  "sources": {
+    "script": "",
+    "host": {},
+    "requester": ""
+  },
+  "creationTime": "2003-04-16T21:06:00",
+  "timeStamp": "00000"
+}

package/validation/tests/targets/autocomplete/bad.html

@@ -0,0 +1,20 @@
+<!DOCTYPE html>
+<html lang="en-US">
+  <head>
+    <meta charset="utf-8">
+    <title>Page with incorrect autocomplete attributes</title>
+    <meta name="description" content="tester">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+  </head>
+  <body>
+    <main>
+      <h1>Page with incorrect autocomplete attributes</h1>
+      <p><label>Your first name <input width="40rem" autocomplete="first-name"></label></p>
+      <p><label>Your last name <input type="text" width="40rem"></label></p>
+      <p><label>Your email address <input width="40rem"></label></p>
+      <p><label>
+        Your email address again <input type="email" width="40rem" autocomplete="email-address">
+      </label></p>
+    </main>
+  </body>
+</html>

package/validation/tests/targets/autocomplete/good.html

@@ -0,0 +1,22 @@
+<!DOCTYPE html>
+<html lang="en-US">
+  <head>
+    <meta charset="utf-8">
+    <title>Page with correct autocomplete attributes</title>
+    <meta name="description" content="tester">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+  </head>
+  <body>
+    <main>
+      <h1>Page with correct autocomplete attributes</h1>
+      <p><label>Your first name <input width="40rem" autocomplete="given-name"></label></p>
+      <p><label>
+        Your last name <input type="text" width="40rem" autocomplete="family-name">
+      </label></p>
+      <p><label>Your email address <input width="40rem" autocomplete="email"></label></p>
+      <p><label>
+        Your email address again <input type="email" width="40rem" autocomplete="email">
+      </label></p>
+    </main>
+  </body>
+</html>