testaro 2.2.9 → 2.3.0

package/README.md

@@ -38,8 +38,8 @@ As of this version, the counts of tests in the packages referenced above were:
 - Equal Access: 163
 - WAVE: 110
 - subtotal: 612
-- Testaro tests: 15
-- grand total: 627
+- Testaro tests: 16
+- grand total: 628
 
 ## Code organization
 
@@ -279,6 +279,8 @@ The data for scores can include not only test results, but also log statistics.
 - `visitTimeoutCount`: how many times an attempt to visit a URL timed out
 - `visitRejectionCount`: how many times a URL visit got an HTTP status other than 200 or 304
 
+Those log statistics can provide data for a log-based test defined in a score proc.
+
 A good score proc takes account of duplications between test packages: two or more packages that discover the same accessibility defects. Score procs can apply discounts to reflect duplications between test packages, so that, if two or more packages discover the same defect, the defect will not be overweighted.
 
 The procedures in the `scoring` directory have produced data there that score procs can use for the calibration of discounts.

package/commands.js

@@ -119,11 +119,11 @@ exports.commands = {
       }
     ],
     text: [
-      'Enter text into a text input',
+      'Enter text into a text input, optionally with 1 placeholder for an all-caps literal environment variable',
       {
         which: [true, 'string', 'hasLength', 'substring of input text'],
         index: [false, 'number', '', 'index among matches if not 0'],
-        what: [true, 'string', 'hasLength', 'text to enter']
+        what: [true, 'string', 'hasLength', 'text to enter, with optional __PLACEHOLDER__']
       }
     ],
     url: [

package/index.js

@@ -1006,8 +1006,17 @@ const doActs = async (report, actIndex, page) => {
                     ? `“${optionText}}” selected`
                     : 'ERROR: option not found';
                 }
-                // Otherwise, if it is entering text on the element, perform it.
+                // Otherwise, if it is entering text on the element:
                 else if (act.type === 'text') {
+                  // If the text contains a placeholder for an environment variable:
+                  let {what} = act; 
+                  if (/__[A-Z]+__/.test(what)) {
+                    // Replace it.
+                    const envKey = /__([A-Z]+)__/.exec(what)[1];
+                    const envValue = process.env[envKey];
+                    what = what.replace(/__[A-Z]+__/, envValue);
+                  }
+                  // Enter the text.
                   await whichElement.type(act.what);
                   report.presses += act.what.length;
                   act.result = 'entered';

package/package.json

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