testaro 10.2.0 → 10.3.0

package/actSpecs.js

@@ -229,6 +229,17 @@ exports.actSpecs = {
         withItems: [true, 'boolean', '', 'itemize']
       }
     ],
+    htmlcs: [
+      'Perform an htmlcs test',
+      {
+        rules: [
+          false,
+          'array',
+          'areStrings',
+          'rule names (e.g., Principle1.Guideline1_4.1_4_9), if not all'
+        ]
+      }
+    ],
     ibm: [
       'Perform an IBM Equal Access test',
       {

package/package.json

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

package/tests/htmlcs.js

@@ -5,8 +5,9 @@
 
 // FUNCTIONS
 // Runs HTML CodeSniffer on the page.
-exports.reporter = async page => {
+exports.reporter = async (page, rules) => {
   const result = {};
+  // Add the HTMLCS script to the page.
   await page.addScriptTag({
     path: `${__dirname}/../htmlcs/HTMLCS.js`
   })
@@ -17,17 +18,26 @@ exports.reporter = async page => {
   });
   if (! result.prevented) {
     let messageStrings = [];
-    for (const standard of ['WCAG2AA']) {
-      const nextIssues = await page.evaluate(standard => {
+    // Define the rules to be employed as those of WCAG 2 level AAA.
+    for (const standard of ['WCAG2AAA']) {
+      const nextIssues = await page.evaluate(args => {
+        const standard = args[0];
+        const rules = args[1];
+        // If only some rules are to be employed:
+        if (rules && Array.isArray(rules) && rules.length) {
+          // Redefine WCAG 2 AAA as including only them.
+          window.HTMLCS_WCAG2AAA.sniffs = rules;
+        }
+        // Run the tests.
         let issues = null;
         try {
-          issues = window['HTMLCS_RUNNER'].run(standard);
+          issues = window.HTMLCS_RUNNER.run(standard);
         }
         catch(error) {
           console.log(`ERROR executing HTMLCS_RUNNER on ${document.URL} (${error.message})`);
         }
         return issues;
-      }, standard);
+      }, [standard, rules]);
       if (nextIssues && nextIssues.every(issue => typeof issue === 'string')) {
         messageStrings.push(... nextIssues);
       }