testaro 13.0.2 → 14.1.0

package/tests/ibm.js

@@ -2,9 +2,8 @@
   ibm
   This test implements the IBM Equal Access ruleset for accessibility.
   The 'withNewContent' argument determines whether the test package should be
-  given the URL of the page to be tested (true), should be given the page content
-  (false), or should test in both ways (omitted).
-
+  given the URL of the page to be tested (true) or the page content (false).
+  
   This test depends on aceconfig.js.
 
   This test is compatible with Windows only if the accessibility-checker package
@@ -122,49 +121,22 @@ const doTest = async (content, withItems, timeLimit, rules) => {
     };
   }
 };
-// Returns results of one or two IBM tests.
+// Returns results of an IBM test.
 exports.reporter = async (page, withItems, withNewContent, rules) => {
-  let contentType = 'both';
-  if (withNewContent) {
-    contentType = 'new';
-  }
-  else if (withNewContent === false) {
-    contentType = 'existing';
-  }
+  const contentType = withNewContent ? 'new' : 'existing';
   console.log(`>>>>>> Content type: ${contentType}`);
-  // If a test with existing content is to be performed:
-  const result = {};
-  const timeLimit = 20;
-  if (['existing', 'both'].includes(contentType)) {
-    try {
-      console.log('>>>>>> With existing content');
-      const typeContent = await page.content();
-      result.content = await doTest(typeContent, withItems, timeLimit, rules);
-      if (result.content.prevented) {
-        result.prevented = true;
-        console.log(`ERROR: Getting ibm test report from page timed out at ${timeLimit} seconds`);
-      }
-    }
-    catch(error) {
-      result.prevented = true;
-      console.log(`ERROR: ibm test on page crashed with error ${error.message.slice(0, 200)}`);
+  let result;
+  const timeLimit = 30;
+  const typeContent = contentType === 'existing' ? await page.content() : await page.url();
+  try {
+    result = await doTest(typeContent, withItems, timeLimit, rules);
+    if (result.prevented) {
+      console.log(`ERROR: Getting ibm test report timed out at ${timeLimit} seconds`);
     }
   }
-  // If a test with new content is to be performed:
-  if (['new', 'both'].includes(contentType)) {
-    try {
-      console.log('>>>>>> With new content');
-      const typeContent = page.url();
-      result.url = await doTest(typeContent, withItems, timeLimit, rules);
-      if (result.url.prevented) {
-        result.prevented = true;
-        console.log(`ERROR: Getting ibm test report from URL timed out at ${timeLimit} seconds`);
-      }
-    }
-    catch(error) {
-      result.prevented = true;
-      console.log(`ERROR: ibm test on URL crashed with error ${error.message.slice(0, 200)}`);
-    }
+  catch(error) {
+    result.prevented = true;
+    console.log(`ERROR: ibm test crashed with error ${error.message.slice(0, 200)}`);
   }
   // Return the result. Execution of close() crashed the Node process.
   return {result};

package/tests/testaro.js

@@ -0,0 +1,73 @@
+/*
+  testaro
+  This test implements the Testaro evaluative ruleset for accessibility.
+*/
+
+// CONSTANTS
+
+const evalRules = {
+  allHidden: 'page that is entirely or mostly hidden',
+  autocomplete: 'name and email inputs without autocomplete attributes',
+  bulk: 'large count of visible elements',
+  docType: 'document without a doctype property',
+  dupAtt: 'elements with duplicate attributes',
+  embAc: 'active elements embedded in links or buttons',
+  filter: 'filter styles on elements',
+  focAll: 'discrepancies between focusable and Tab-focused elements',
+  focInd: 'missing and nonstandard focus indicators',
+  focOp: 'discrepancies between focusability and operability',
+  focVis: 'links that are invisible when focused',
+  hover: 'hover-caused content changes',
+  labClash: 'labeling inconsistencies',
+  linkTo: 'links without destinations',
+  linkUl: 'missing underlines on inline links',
+  menuNav: 'nonstandard keyboard navigation between focusable menu items',
+  miniText: 'text smaller than 11 pixels',
+  motion: 'motion without user request',
+  nonTable: 'table elements used for layout',
+  radioSet: 'radio buttons not grouped into standard field sets',
+  role: 'invalid, inadvised, and redundant explicit roles',
+  styleDiff: 'style inconsistencies',
+  tabNav: 'nonstandard keyboard navigation between elements with the tab role',
+  title: 'missing page title',
+  titledEl: 'title attributes on inappropriate elements',
+  zIndex: 'non-default Z indexes'
+};
+const etcRules = {
+  attVal: 'elements with attributes having illicit values',
+  elements: 'data on specified elements',
+  textNodes: 'data on specified text nodes',
+  title: 'page title',
+};
+
+// FUNCTIONS
+
+// Conducts and reports a Testaro test.
+exports.reporter = async (
+  page, withItems, rules = ['y', ... Object.keys(evalRules)], args = null
+) => {
+  // Initialize the data.
+  const data = {
+    rules: {}
+  };
+  // For each rule invoked:
+  const argRules = args && Object.keys(args);
+  const realRules = rules[0] === 'y'
+    ? rules.slice(1)
+    : Object.keys(evalRules).filter(ruleName => ! rules.slice(1).includes(ruleName));
+  for (const rule of realRules) {
+    // Initialize an argument array.
+    const ruleArgs = [page, withItems];
+    // If the rule has extra arguments:
+    if (argRules && argRules.includes(rule)) {
+      // Add them to the argument array.
+      ruleArgs.push(... args[rule]);
+    }
+    // Test the page.
+    data.rules[rule] = await require(`../testaro/${rule}`).reporter(... ruleArgs);
+    const what = evalRules[rule] || etcRules[rule];
+    data.rules[rule].what = what;
+    console.log(`>>>>>> ${rule} (${what})`);
+  }
+  return {result: data};
+};