testaro 33.0.2 → 33.1.0

package/README.md

@@ -144,7 +144,6 @@ Here is an example of a job:
   timeLimit: 65,
   standard: 'only',
   observe: false,
-  timeStamp: '231208T1200',
   acts: [
     {
       type: 'launch',
@@ -164,12 +163,15 @@ Here is an example of a job:
     batch: 'weborgs',
     target: {
       id: 'w3c',
-      which: 'https://www.w3c.org',
-      what: 'World Wide Web Consortium'
+      what: 'World Wide Web Consortium',
+      which: 'https://www.w3c.org'
     },
     requester: 'user@domain.org'
   },
-  creationTime: '2024-12-10T14:28Z'
+  timeStamp: '241208T1200',
+  creationTimeStamp: '241114T0328',
+  sendReportTo: 'https://localhost:3004/testapp/api/report',
+  mergeID: Q9
 }
 ```
 
@@ -185,13 +187,17 @@ Job properties:
 - `standard`: `'also'`, `'only'`, or `'no'`, indicating whether rule-violation instances are to be reported in tool-native formats and also in the Testaro standard format, only in the standard format, or only in the tool-native formats.
 - `observe`: `true` or `false`, indicating whether tool and Testaro-rule invocations are to be reported as they occur to the server.
 - `timeStamp`: a string in `yymmddThhMM` format, specifying a date and time before which the job is not to be performed.
+- `creationTimeStamp`: a string in `yymmddThhMM` format, describing when the job was created.
 - `acts`: an array of the acts to be performed (documented below).
 - `sources`: an object describing where the job came from:
-   - `script` (optional): the ID of the script from which the job was made.
-   - `batch` (optional): a set of targets (URLs) from which the target of this job was drawn.
-   - `target` (optional): an object describing the target being tested by this job.
-   - `requester` (optional): the email address that should receive a notice of completion of the job.
-- `creationTime`: the date and time in ISO 8601 format when the job was created.
+   - `script`: the ID of the script (as used by Testilo) from which the job was made, or an empty string if none.
+   - `batch` : the ID of the batch (as used by Testilo) from which the target of this job was drawn, or an empty string if none.
+   - `target`: an object whose `id`, `what`, and `which` properties describe the target being tested by this job, or, if there was no batch, have empty strings as values.
+   - `requester`: the email address that should receive a notice of completion of the job, or an empty string if no notice is to be sent.
+- `creationTimeStamp`: the date and time in `yymmddThhMM` format when the job was created.
+- `timeStamp`: the date and time in `yymmddThhMM` format before which the job is not to be assigned.
+- `sendReportTo`: the URL to which the report of the job is to be sent, or an empty string if the report is not to be sent to a server.
+- `mergeID`: a randomly generated alphanumeric ID for the process (such as a merger, as performed by Testilo, of a script and a batch) that created the job, or an empty string if none.
 
 ### Reports
 
@@ -757,7 +763,7 @@ node call run be76p
 
 In the second example, `be76p` is the initial characters of the ID of a job saved as a JSON file in the `todo` subdirectory of the `process.env.JOBDIR` directory.
 
-The `call` module will find the first job file with a matching name if an argument is given, or the first job file if not. Then the module will execute the `doJob` function of the `run` module on the job, save the report in the `raw` subdirectory of the `process.env.REPORTDIR` directory, and archive the job file in the `done` subdirectory of the `process.env.JOBDIR` directory.
+The `call` module will find the first job file with a matching name if an argument is given, or the first job file if not. Then the module will execute the `doJob` function of the `run` module on the job, save the report in the `raw` subdirectory of the `REPORTDIR` directory, and archive the job file in the `done` subdirectory of the `JOBDIR` directory.
 
 #### Watch
 
@@ -796,7 +802,7 @@ An instance of Testaro is an _agent_ and has an identifier specified by `process
 
 The URLs polled by Testaro are specified by `process.env.JOB_URLS`. The format of that environment variable is a `+`-delimited list of URLs, including schemes. If one of the URLs is `https://testrunner.org/a11ytest/api/job`, and if a Testaro instance has the agent ID `tester3`, then a job request is a `GET` request to `https://testrunner.org/a11ytest/api/job?agent=tester3`.
 
-Once a Testaro instance obtains a network job, Testaro performs it and adds the result data to the job, which then becomes the job report. Testaro sends the report in a `POST` request to the URL specified by the `sources.sendReportTo` property of the job.
+Once a Testaro instance obtains a network job, Testaro performs it and adds the result data to the job, which then becomes the job report. Testaro sends the report in a `POST` request to the URL specified by the `sendReportTo` property of the job.
 
 Network watching can be repeated or 1-job. One-job watching stops after 1 job has been performed.
 

package/call.js

@@ -69,6 +69,9 @@ const callRun = async jobIDStart => {
     // Get it.
     const jobJSON = await fs.readFile(`${todoDir}/${jobFileName}`, 'utf8');
     const report = JSON.parse(jobJSON);
+    // Ensure it does not specify server properties.
+    report.observe = false;
+    report.sendReportTo = '';
     // Run it.
     await doJob(report);
     // Archive it.

package/dirWatch.js

@@ -44,7 +44,7 @@ const reportDir = process.env.REPORTDIR;
 // Gets a segment of a timestamp.
 const tsPart = (timeStamp, startIndex) => timeStamp.slice(startIndex, startIndex + 2);
 // Returns a string representing the date and time.
-const nowString = () => (new Date()).toISOString().slice(0, 16);
+const nowString = () => (new Date()).toISOString().slice(2, 16);
 // Gets date of a timestamp.
 const dateOf = ts => {
   const dateString = `20${tsPart(ts, 0)}-${tsPart(ts, 2)}-${tsPart(ts, 4)}`;
@@ -117,6 +117,11 @@ exports.dirWatch = async (isForever, intervalInSeconds) => {
           try {
             const job = JSON.parse(jobJSON);
             const report = JSON.parse(jobJSON);
+            // Ensure it has no server properties.
+            job.observe = false;
+            job.sendReportTo = '';
+            report.observe = false;
+            report.sendReportTo = '';
             const {id} = job;
             console.log(`Directory job ${id} ready to do (${nowString()})`);
             // Perform it.

package/netWatch.js

@@ -45,7 +45,7 @@ const agent = process.env.AGENT;
 // FUNCTIONS
 
 // Returns a string representing the date and time.
-const nowString = () => (new Date()).toISOString().slice(2, 15);
+const nowString = () => (new Date()).toISOString().slice(2, 16);
 // Waits.
 const wait = ms => {
   return new Promise(resolve => {
@@ -141,7 +141,7 @@ exports.netWatch = async (isForever, intervalInSeconds, isCertTolerant = true) =
                 }
                 // Otherwise, i.e. if there was a job or a message:
                 else {
-                  const {message, id, sources} = contentObj;
+                  const {id, message, sendReportTo, sources} = contentObj;
                   // If the server sent a message, not a job:
                   if (message) {
                     // Report it.
@@ -157,11 +157,10 @@ exports.netWatch = async (isForever, intervalInSeconds, isCertTolerant = true) =
                     // Add the agent to the job.
                     sources.agent = agent;
                     // If the job specifies a report destination:
-                    const {sendReportTo} = sources;
                     if (sendReportTo) {
                       // Perform the job, adding result data to it.
                       const target = sources.target.which;
-                      console.log(`${logStart}job ${id} (${nowString()}`);
+                      console.log(`${logStart}job ${id} (${nowString()})`);
                       console.log(`>> It will test ${target}`);
                       console.log(`>> It will send report to ${sendReportTo}`);
                       await doJob(contentObj);
@@ -220,7 +219,9 @@ exports.netWatch = async (isForever, intervalInSeconds, isCertTolerant = true) =
                       // If the report submission throws an error:
                       .on('error', async error => {
                         // Report this.
-                        console.log(`ERROR: ${reportLogStart}error message ${error.message}\n`);
+                        console.log(
+                          `ERROR in report submission: ${reportLogStart}error message ${error.message}\n`
+                        );
                         resolve(true);
                       })
                       // Finish submitting the report.
@@ -230,8 +231,8 @@ exports.netWatch = async (isForever, intervalInSeconds, isCertTolerant = true) =
                     else {
                       // Report this.
                       const message = `ERROR: ${logStart}job with no report destination`;
-                      serveObject({message}, response);
                       console.log(message);
+                      serveObject({message}, response);
                       resolve(true);
                     }
                   }
@@ -249,7 +250,9 @@ exports.netWatch = async (isForever, intervalInSeconds, isCertTolerant = true) =
               // If processing the server response throws an error:
               catch(error) {
                 // Report this.
-                console.log(`ERROR: ${error.message} (response ${content.slice(0, 1000)})`);
+                console.log(
+                  `ERROR processing server response: ${error.message} (response ${content.slice(0, 1000)})`
+                );
                 resolve(true);
               }
             });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "testaro",
-  "version": "33.0.2",
+  "version": "33.1.0",
   "description": "Run 1000 web accessibility tests from 10 tools and get a standardized report",
   "main": "index.js",
   "scripts": {

package/procs/standardize.js

@@ -395,7 +395,6 @@ const convert = (toolName, data, result, standardResult) => {
               && ruleResult.message.actual
               && ruleResult.message.actual.description
             ) {
-
               const what = ruleResult.message.actual.description;
               // Get its differentiated ID if any.
               const ruleData = aslintData[ruleID];
@@ -409,10 +408,16 @@ const convert = (toolName, data, result, standardResult) => {
                 }
               }
               const xpath = ruleResult.element && ruleResult.element.xpath || '';
-              const tagName = xpath
+              let tagName = xpath
               && xpath.replace(/^.*\//, '').replace(/[^-\w].*$/, '').toUpperCase()
               || '';
+              if (! tagName && finalRuleID.endsWith('_svg')) {
+                tagName = 'SVG';
+              }
               const excerpt = ruleResult.element && ruleResult.element.html || '';
+              if (! tagName && /^<[a-z]+[ >]/.test(excerpt)) {
+                tagName = excerpt.slice(1).replace(/[ >]+/, '').toUpperCase();
+              }
               const idDraft = excerpt && excerpt.replace(/^[^[>]+id="/, 'id=').replace(/".*$/, '');
               const id = idDraft && idDraft.length > 3 && idDraft.startsWith('id=')
                 ? idDraft.slice(3)

package/procs/tellServer.js

@@ -35,7 +35,7 @@ const agent = process.env.AGENT;
 
 // Sends a notification to an observer.
 exports.tellServer = (report, messageParams, logMessage) => {
-  const observer = report.sources.sendReportTo.replace(/report$/, 'granular');
+  const observer = report.sendReportTo.replace(/report$/, 'granular');
   const whoParams = `agent=${agent}&jobID=${report.id || ''}`;
   const wholeURL = `${observer}?${whoParams}&${messageParams}`;
   const client = wholeURL.startsWith('https://') ? httpsClient : httpClient;

package/run.js

@@ -224,11 +224,31 @@ const isValidAct = act => {
     return false;
   }
 };
+// Inserts a character periodically in a string.
+const punctuate = (string, insertion, chunkSize) => {
+  const segments = [];
+  let startIndex = 0;
+  while (startIndex < string.length) {
+    segments.push(string.slice(startIndex, startIndex + chunkSize));
+    startIndex += chunkSize;
+  }
+  return segments.join(insertion);
+};
+// Converts a compact timestamp to a date.
+const dateOf = timeStamp => {
+  if (/^\d{6}T\d{4}$/.test(timeStamp)) {
+    const dateString = punctuate(timeStamp.slice(0, 6), '-', 2);
+    const timeString = punctuate(timeStamp.slice(7, 11), ':', 2);
+    return new Date(`20${dateString}T${timeString}Z`);
+  } else {
+    return null;
+  }
+};
 // Validates a report object.
 const isValidReport = report => {
   if (report) {
     // Return whether the report is valid.
-    const {id, what, strict, timeLimit, acts, sources, creationTime, timeStamp} = report;
+    const {id, what, strict, timeLimit, acts, sources, creationTimeStamp, timeStamp} = report;
     if (! id || typeof id !== 'string') {
       return 'Bad report ID';
     }
@@ -278,11 +298,13 @@ const isValidReport = report => {
     if (typeof sources.script !== 'string') {
       return 'Bad source script';
     }
-    if (! (creationTime && typeof creationTime === 'string' && Date.parse(creationTime))) {
-      return 'bad job creation time';
+    if (
+      ! (creationTimeStamp && typeof creationTimeStamp === 'string' && dateOf(creationTimeStamp))
+    ) {
+      return 'bad job creation time stamp';
     }
     if (! (timeStamp && typeof timeStamp === 'string')) {
-      return 'bad report timestamp';
+      return 'bad report time stamp';
     }
     return '';
   }
@@ -530,7 +552,7 @@ const launch = async (report, typeName, url, debug, waits, isLowMotion = false)
   }
 };
 // Returns a string representing the date and time.
-const nowString = () => (new Date()).toISOString().slice(0, 19);
+const nowString = () => (new Date()).toISOString().slice(2, 16);
 // Returns the first line of an error message.
 const errorStart = error => error.message.replace(/\n.+/s, '');
 // Normalizes spacing characters and cases in a string.

package/watch.js

@@ -47,7 +47,7 @@ const agent = process.env.AGENT;
 // ########## FUNCTIONS
 
 // Returns a string representing the date and time.
-const nowString = () => (new Date()).toISOString().slice(0, 19);
+const nowString = () => (new Date()).toISOString().slice(2, 16);
 // Waits.
 const wait = ms => {
   return new Promise(resolve => {
@@ -205,7 +205,7 @@ const checkNetJob = async (servers, serverIndex, isForever, interval, noJobCount
         }
         // Otherwise, i.e. if there was a job or a message:
         else {
-          const {message, id, sources} = contentObj;
+          const {id, message, sendReportTo, sources} = contentObj;
           // If the server sent a message, not a job:
           if (message) {
             // Report it.
@@ -218,7 +218,6 @@ const checkNetJob = async (servers, serverIndex, isForever, interval, noJobCount
             // Add the agent to it.
             sources.agent = agent;
             // If the job specifies a report destination:
-            const {sendReportTo} = sources;
             if (sendReportTo) {
               // Perform the job, adding result data to it.
               const testee = sources.target.which;

package/netWatch-old.js

@@ -1,397 +0,0 @@
-/*
-  © 2022–2023 CVS Health and/or one of its affiliates. All rights reserved.
-
-  Permission is hereby granted, free of charge, to any person obtaining a copy
-  of this software and associated documentation files (the "Software"), to deal
-  in the Software without restriction, including without limitation the rights
-  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-  copies of the Software, and to permit persons to whom the Software is
-  furnished to do so, subject to the following conditions:
-
-  The above copyright notice and this permission notice shall be included in all
-  copies or substantial portions of the Software.
-
-  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-  SOFTWARE.
-*/
-
-/*
-  netWatch.js
-  Module for watching for a network job and running it when found.
-*/
-
-// ########## IMPORTS
-
-// Module to keep secrets.
-require('dotenv').config();
-// Module to read and write files.
-const fs = require('fs/promises');
-// Module to make requests to servers.
-const httpClient = require('http');
-const httpsClient = require('https');
-// Module to perform jobs.
-const {doJob} = require('./run');
-
-// CONSTANTS
-
-const jobDir = process.env.JOBDIR;
-const jobURLs = process.env.JOB_URLS;
-const reportDir = process.env.REPORTDIR;
-const agent = process.env.AGENT;
-
-// ########## FUNCTIONS
-
-// Returns a string representing the date and time.
-const nowString = () => (new Date()).toISOString().slice(0, 19);
-// Waits.
-const wait = ms => {
-  return new Promise(resolve => {
-    setTimeout(() => {
-      resolve('');
-    }, ms);
-  });
-};
-// Serves an object in JSON format.
-const serveObject = (object, response) => {
-  response.setHeader('Content-Type', 'application/json; charset=utf-8');
-  response.end(JSON.stringify(object));
-};
-// Writes a directory report.
-const writeDirReport = async report => {
-  const jobID = report && report.id;
-  if (jobID) {
-    try {
-      const reportJSON = JSON.stringify(report, null, 2);
-      const reportName = `${jobID}.json`;
-      await fs.mkdir(reportDir, {recursive: true});
-      await fs.writeFile(`${reportDir}/${reportName}`, reportJSON);
-      console.log(`Report ${reportName} saved in ${reportDir}`);
-    }
-    catch(error) {
-      console.log(`ERROR: Failed to write report ${jobID} in ${reportDir} (${error.message})`);
-    }
-  }
-  else {
-    console.log('ERROR: Job has no ID');
-  }
-};
-// Archives a job.
-const archiveJob = async (job, isFile) => {
-  // Save the job in the done subdirectory.
-  const {id} = job;
-  const jobJSON = JSON.stringify(job, null, 2);
-  await fs.mkdir(`${jobDir}/done`, {recursive: true});
-  await fs.writeFile(`${jobDir}/done/${id}.json`, jobJSON);
-  // If the job had been saved as a file in the todo subdirectory:
-  if (isFile) {
-    // Delete the file.
-    await fs.rm(`${jobDir}/todo/${id}.json`);
-  }
-};
-// Checks for a directory job and, if found, performs and reports it, once or repeatedly.
-const checkDirJob = async (isForever, interval) => {
-  try {
-    // If there are any jobs in the watched directory:
-    const toDoFileNames = await fs.readdir(`${jobDir}/todo`);
-    const jobFileNames = toDoFileNames.filter(fileName => fileName.endsWith('.json'));
-    if (jobFileNames.length) {
-      // If the first one is ready to do:
-      const firstJobTime = jobFileNames[0].replace(/-.+$/, '');
-      if (Date.now() > dateOf(firstJobTime)) {
-        // Perform it.
-        const jobJSON = await fs.readFile(`${jobDir}/todo/${jobFileNames[0]}`, 'utf8');
-        try {
-          const job = JSON.parse(jobJSON, null, 2);
-          const {id} = job;
-          console.log(`Directory job ${id} found (${nowString()})`);
-          await doJob(job);
-          console.log(`Job ${id} finished (${nowString()})`);
-          // Report it.
-          await writeDirReport(job);
-          // Archive it.
-          await archiveJob(job, true);
-          console.log(`Job ${id} archived in ${jobDir} (${nowString()})`);
-          // If watching is repetitive:
-          if (isForever) {
-            // Wait 2 seconds.
-            await wait(2000);
-            // Check the directory again.
-            checkDirJob(true, interval);
-          }
-        }
-        catch(error) {
-          console.log(`ERROR processing directory job (${error.message})`);
-        }
-      }
-      // Otherwise, i.e. if the first one is not yet ready to do:
-      else {
-        // Report this.
-        console.log(`All jobs in ${jobDir} not yet ready to do (${nowString()})`);
-        // Wait for the specified interval.
-        await wait(1000 * interval);
-        // Check the directory again.
-        await checkDirJob(true, interval);
-      }
-    }
-    // Otherwise, i.e. if there are no more jobs in the watched directory:
-    else {
-      console.log(`No job in ${jobDir} (${nowString()})`);
-      // Wait for the specified interval.
-      await wait(1000 * interval);
-      // Check the directory again.
-      await checkDirJob(true, interval);
-    }
-  }
-  catch(error) {
-    console.log(`ERROR: Directory watching failed (${error.message})`);
-  }
-};
-// Checks servers for a network job.
-const checkNetJob = async (servers, serverIndex, isForever, interval, noJobCount) => {
-  // If all servers are jobless:
-  if (noJobCount === servers.length) {
-    // Wait for the specified interval.
-    await wait(1000 * interval);
-    // Reset the count of jobless servers.
-    noJobCount = 0;
-  }
-  // Otherwise, i.e. if any server may still have a job:
-  else {
-    // Wait 2 seconds.
-    await wait(2000);
-  }
-  // If the last server has been checked:
-  serverIndex = serverIndex % servers.length;
-  if (serverIndex === 0) {
-    // Report this.
-    console.log('--');
-  }
-  // Check the next server.
-  const server = servers[serverIndex];
-  const client = server.startsWith('https://') ? httpsClient : httpClient;
-  const fullURL = `${server}?agent=${agent}`;
-  const logStart = `Requested job from server ${server} and got `;
-  // Tolerate unrecognized certificate authorities if the environment specifies.
-  const ruOpt = process.env.REJECT_UNAUTHORIZED === 'false' ? {rejectUnauthorized: false} : {};
-  client.request(fullURL, ruOpt, response => {
-    const chunks = [];
-    response
-    // If the response to the job request threw an error:
-    .on('error', async error => {
-      // Report it.
-      console.log(`${logStart}error message ${error.message}`);
-      // Check the next server.
-      await checkNetJob(servers, serverIndex + 1, isForever, interval, noJobCount + 1);
-    })
-    .on('data', chunk => {
-      chunks.push(chunk);
-    })
-    // When the response arrives:
-    .on('end', async () => {
-      const content = chunks.join('');
-      try {
-        // If there was no job to do:
-        let contentObj = JSON.parse(content);
-        if (! Object.keys(contentObj).length) {
-          // Report this.
-          console.log(`No job to do at ${server}`);
-          // Check the next server.
-          await checkNetJob(servers, serverIndex + 1, isForever, interval, noJobCount + 1);
-        }
-        // Otherwise, i.e. if there was a job or a message:
-        else {
-          const {message, id, sources} = contentObj;
-          // If the server sent a message, not a job:
-          if (message) {
-            // Report it.
-            console.log(`${logStart}${message}`);
-            // Check the next server.
-            await checkNetJob(servers, serverIndex + 1, isForever, interval, noJobCount + 1);
-          }
-          // Otherwise, if the server sent a valid job:
-          else if (id && sources && sources.target && sources.target.which) {
-            // Add the agent to it.
-            sources.agent = agent;
-            // If the job specifies a report destination:
-            const {sendReportTo} = sources;
-            if (sendReportTo) {
-              // Perform the job, adding result data to it.
-              const testee = sources.target.which;
-              console.log(
-                `${logStart}job ${id} (${nowString()})\n>> It will test ${testee}\n>> It will send report to ${sendReportTo}\n`
-              );
-              await doJob(contentObj);
-              let reportJSON = JSON.stringify(contentObj, null, 2);
-              console.log(`Job ${id} finished (${nowString()})`);
-              // Send the report to the specified server.
-              console.log(`Sending report ${id} to ${sendReportTo}`);
-              const reportClient = sendReportTo.startsWith('https://') ? httpsClient : httpClient;
-              const reportLogStart = `Sent report ${id} to ${sendReportTo} and got `;
-              reportClient.request(sendReportTo, {method: 'POST'}, repResponse => {
-                const chunks = [];
-                repResponse
-                // If the response to the report threw an error:
-                .on('error', async error => {
-                  // Report this.
-                  console.log(`${reportLogStart}error message ${error.message}\n`);
-                  // Check the next server.
-                  await checkNetJob(servers, serverIndex + 1, isForever, interval, noJobCount + 1);
-                })
-                .on('data', chunk => {
-                  chunks.push(chunk);
-                })
-                // When the response arrives:
-                .on('end', async () => {
-                  const content = chunks.join('');
-                  try {
-                    // If the server sent a message, as expected:
-                    const ackObj = JSON.parse(content);
-                    const {message} = ackObj;
-                    if (message) {
-                      // Report it.
-                      console.log(`${reportLogStart}${message}\n`);
-                      // Free the memory used by the report.
-                      reportJSON = '';
-                      contentObj = {};
-                      // Check the next server.
-                      await checkNetJob(servers, serverIndex + 1, isForever, interval, 0);
-                    }
-                    // Otherwise, i.e. if the server sent anything else:
-                    else {
-                      // Report it.
-                      console.log(
-                        `ERROR: ${reportLogStart}status ${repResponse.statusCode} and error message ${JSON.stringify(ackObj, null, 2)}\n`
-                      );
-                      // Check the next server, disregarding the failed job.
-                      await checkNetJob(
-                        servers, serverIndex + 1, isForever, interval, noJobCount + 1
-                      );
-                    }
-                  }
-                  // If processing the report threw an error:
-                  catch(error) {
-                    // Report it.
-                    console.log(
-                      `ERROR: ${reportLogStart}status ${repResponse.statusCode}, error message ${error.message}, and response ${content.slice(0, 1000)}\n`
-                    );
-                    // Check the next server, disregarding the failed job.
-                    await checkNetJob(
-                      servers, serverIndex + 1, isForever, interval, noJobCount + 1
-                    );
-                  }
-                });
-              })
-              // If the report submission throws an error:
-              .on('error', async error => {
-                // Report this.
-                console.log(`ERROR: ${reportLogStart}error message ${error.message}\n`);
-                // Check the next server, disregarding the failed job.
-                await checkNetJob(servers, serverIndex + 1, isForever, interval, noJobCount + 1);
-              })
-              // Finish submitting the report.
-              .end(reportJSON);
-            }
-            // Otherwise, i.e. if the job specifies no report destination:
-            else {
-              // Report this.
-              const message = `ERROR: ${logStart}job with no report destination`;
-              serveObject({message}, response);
-              console.log(message);
-              // Check the next server, disregarding the defective job.
-              await checkNetJob(servers, serverIndex + 1, isForever, interval, noJobCount + 1);
-            }
-          }
-          // Otherwise, if the server sent an invalid job:
-          else {
-            // Report this.
-            const message
-            = `ERROR: ${logStart}invalid job:\n${JSON.stringify(contentObj, null, 2)}`;
-            console.log(message);
-            serveObject({message}, response);
-            // Check the next server, disregarding the defective job.
-            await checkNetJob(servers, serverIndex + 1, isForever, interval, noJobCount + 1);
-          }
-        }
-      }
-      // If an error is thrown:
-      catch(error) {
-        // Report this.
-        console.log(`ERROR: ${error.message} (response ${content.slice(0, 1000)})`);
-        // Check the next server.
-        await checkNetJob(servers, serverIndex + 1, isForever, interval, noJobCount + 1);
-      }
-    });
-  })
-  // If the job request throws an error:
-  .on('error', async error => {
-    // If it was a refusal to connect:
-    const {message} = error;
-    if (message.includes('ECONNREFUSED')) {
-      // Report this.
-      console.log(`${logStart}no connection`);
-      // Check the next server.
-      await checkNetJob(servers, serverIndex + 1, isForever, interval, noJobCount + 1);
-    }
-    // Otherwise, if it was a DNS failure:
-    else if (message.includes('ENOTFOUND')) {
-      // Report this.
-      console.log(`${logStart}no domain name resolution`);
-      // Check the next server.
-      await checkNetJob(servers, serverIndex + 1, isForever, interval, noJobCount + 1);
-    }
-    // Otherwise, i.e. if it was any other error:
-    else {
-      // Report this.
-      console.log(
-        `ERROR: ${logStart}no response, but got error message ${error.message.slice(0, 200)}`
-      );
-      // Check the next server.
-      await checkNetJob(servers, serverIndex + 1, isForever, interval, noJobCount + 1);
-    }
-  })
-  // Finish sending the request.
-  .end();
-};
-// Composes an interval description.
-const intervalSpec = interval => {
-  if (interval > -1) {
-    return `repeatedly, with ${interval}-second intervals `;
-  }
-  else {
-    return '';
-  }
-};
-// Checks for a directory job, performs it, and submits a report, once or repeatedly.
-exports.dirWatch = async (isForever, interval = 300) => {
-  console.log(`Directory watching started ${intervalSpec(interval)}(${nowString()})\n`);
-  // Start the checking.
-  await checkDirJob(isForever, interval);
-};
-// Checks for a network job, performs it, and submits a report, once or repeatedly.
-exports.netWatch = async (isForever, interval = 300) => {
-  console.log('Starting netWatch');
-  // If the servers to be checked are valid:
-  const servers = jobURLs
-  .split('+')
-  .map(url => [Math.random(), url])
-  .sort((a, b) => a[0] - b[0])
-  .map(pair => pair[1]);
-  if (
-    servers
-    && servers.length
-    && servers
-    .every(server => ['http://', 'https://'].some(prefix => server.startsWith(prefix)))
-  ) {
-    console.log(`Network watching started ${intervalSpec(interval)}(${nowString()})\n`);
-    // Start checking.
-    await checkNetJob(servers, 0, isForever, interval, 0);
-  }
-  else {
-    console.log('ERROR: List of job URLs invalid');
-  }
-};