testaro 33.1.0 → 33.1.3

package/README.md

@@ -142,8 +142,6 @@ Here is an example of a job:
   what: 'Test W3C with 2 alfa rules',
   strict: true,
   timeLimit: 65,
-  standard: 'only',
-  observe: false,
   acts: [
     {
       type: 'launch',
@@ -168,6 +166,8 @@ Here is an example of a job:
     },
     requester: 'user@domain.org'
   },
+  standard: 'only',
+  observe: false,
   timeStamp: '241208T1200',
   creationTimeStamp: '241114T0328',
   sendReportTo: 'https://localhost:3004/testapp/api/report',
@@ -184,11 +184,11 @@ Job properties:
 - `what`: a description of the job.
 - `strict`: `true` or `false`, indicating whether _substantive redirections_ should be treated as failures. These are redirections that do more than add or subtract a final slash.
 - `timeLimit`: the number of seconds allowed for the execution of the job.
+- `acts`: an array of the acts to be performed (documented below).
 - `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.
+- `observe`: `true` or `false`, indicating whether tool and Testaro-rule invocations are to be reported to the server as they occur, so that the server can update a waiting client.
 - `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`: 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.
@@ -197,7 +197,7 @@ Job properties:
 - `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.
+- `mergeID`: a randomly generated alphanumeric ID for the process (such as a Testilo merger of a script and a batch) that created the job, or an empty string if none.
 
 ### Reports
 
@@ -890,7 +890,7 @@ The Playwright “Receives Events” actionability check does **not** check whet
 
 Test targets employ mechanisms to prevent scraping, automated form submission, and other automated actions. These mechanisms may interfere with testing. When a test act is prevented by a target, Testaro reports this prevention.
 
-Some targets prohibit the execution of alien scripts unless the client can demonstrate that it is the requester of the page. Failure to provide that evidence results in the script being blocked and an error message being logged, saying “Refused to execute a script because its hash, its nonce, or unsafe-inline does not appear in the script-src directive of the Content Security Policy”. This mechanism affects tools that insert scripts into a target in order to test it. Those tools include `axe`, `asLint`, `ed11y`, and `htmlcs`. To comply with this requirement, Testaro obtains a _nonce_ from the response that serves the target. Then the file that runs the tool adds that nonce to the script as the value of a `nonce` attribute when it inserts its script into the target.
+Some targets prohibit the execution of alien scripts unless the client can demonstrate that it is the requester of the page. Failure to provide that evidence results in the script being blocked and an error message being logged, saying “Refused to execute a script because its hash, its nonce, or unsafe-inline does not appear in the script-src directive of the Content Security Policy”. This mechanism affects tools that insert scripts into a target in order to test it. Those tools include `axe`, `aslint`, `ed11y`, and `htmlcs`. To comply with this requirement, Testaro obtains a _nonce_ from the response that serves the target. Then the file that runs the tool adds that nonce to the script as the value of a `nonce` attribute when it inserts its script into the target.
 
 ### Tool duplicativity
 
@@ -913,12 +913,12 @@ The files in the `temp` directory are presumed ephemeral and are not tracked by
 ## Related packages
 
 [Testilo](https://www.npmjs.com/package/testilo) is an application that:
-- merges batches of targets and scripts to produce jobs
+- converts lists of targets and lists of issues into jobs
 - produces scores and adds them to the raw reports of Testaro
 - produces human-oriented HTML digests from scored reports
 - produces human-oriented HTML comparisons of the scores of targets
 
-Testilo contains procedures that reorganize report data by defect rather than tool, and that compensate for duplicative tests when computing scores.
+Testilo contains procedures that reorganize report data by issue rather than tool, and that compensate for duplicative tests when computing scores.
 
 Testaro is derived from [Autotest](https://github.com/jrpool/autotest). Autotest was created as a monolithic accessibility testing package, but that forced functionalities to be hosted on a workstation merely because it was impractical to host Playwright elsewhere. Testaro embodies an architectural decision to isolate workstation-dependent functionalities.
 
@@ -934,14 +934,14 @@ The JavaScript code in this project generally conforms to the ESLint configurati
 
 ## Origin
 
-Work on the custom tests in this package began in 2017, and work on the multi-package federation that Testaro implements began in early 2018. These two aspects were combined into the [Autotest](https://github.com/jrpool/autotest) package in early 2021 and into the more single-purpose packages, Testaro and Testilo, in January 2022.
+Work on the custom tests in this package began in 2017, and work on the multi-package ensemble that Testaro implements began in early 2018. These two aspects were combined into the [Autotest](https://github.com/jrpool/autotest) package in early 2021 and into the more single-purpose packages, Testaro and Testilo, in January 2022.
 
 ## Etymology
 
 “Testaro” means “collection of tests” in Esperanto.
 
 /*
-  © 2021–2023 CVS Health and/or one of its affiliates. All rights reserved.
+  © 2021–2024 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

package/call.js

@@ -1,5 +1,5 @@
 /*
-  © 2022–2023 CVS Health and/or one of its affiliates. All rights reserved.
+  © 2022–2024 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

package/dirWatch.js

@@ -1,5 +1,5 @@
 /*
-  © 2023 CVS Health and/or one of its affiliates. All rights reserved.
+  © 2023–2024 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

package/netWatch.js

@@ -1,5 +1,5 @@
 /*
-  © 2022–2023 CVS Health and/or one of its affiliates. All rights reserved.
+  © 2022–2024 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

package/package.json

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

package/procs/standardize.js

@@ -1,5 +1,5 @@
 /*
-  © 2023 CVS Health and/or one of its affiliates. All rights reserved.
+  © 2023–2024 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

package/procs/tellServer.js

@@ -1,5 +1,5 @@
 /*
-  © 2023 CVS Health and/or one of its affiliates. All rights reserved.
+  © 2023–2024 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

package/run.js

@@ -1,5 +1,5 @@
 /*
-  © 2021–2023 CVS Health and/or one of its affiliates. All rights reserved.
+  © 2021–2024 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

package/tests/wave.js

@@ -63,15 +63,21 @@ exports.reporter = async (page, options) => {
             delete categories.aria;
             // If rules were specified:
             if (rules && rules.length) {
-              // Delete the results of tests for other rules.
+              // For each WAVE rule category:
               ['error', 'contrast', 'alert'].forEach(category => {
+                // If any violations were reported:
                 if (
                   categories[category]
                   && categories[category].items
                   && Object.keys(categories[category].items).length
                 ) {
+                  // For each rule violated:
                   Object.keys(categories[category].items).forEach(ruleID => {
+                    // If it was not a specified rule:
                     if (! rules.includes(ruleID)) {
+                      // Decrease the category violation count by the count of its violations.
+                      categories[category].count -= categories[category].items[ruleID].count;
+                      // Remove its violations from the report.
                       delete categories[category].items[ruleID];
                     }
                   });

package/watch.js

@@ -1,5 +1,5 @@
 /*
-  © 2022–2023 CVS Health and/or one of its affiliates. All rights reserved.
+  © 2022–2024 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