testaro 78.0.6 → 78.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (361) hide show
  1. package/.gitattributes +94 -0
  2. package/.github/workflows/ci.yml +58 -0
  3. package/.github/workflows/publish.yml +49 -0
  4. package/.github/workflows/typescript.yml +35 -0
  5. package/AGENTS.md +2 -2
  6. package/CLAUDE.md +25 -19
  7. package/CONTAINERS.md +10 -6
  8. package/CONTRIBUTING.md +29 -3
  9. package/Dockerfile +1 -1
  10. package/README.md +75 -20
  11. package/UPGRADES.md +4 -0
  12. package/actSpecs-doc.md +13 -1
  13. package/actSpecs.js +29 -5
  14. package/call.js +6 -5
  15. package/docker-compose.yml +8 -2
  16. package/docs/checkpoint-scanning.md +199 -0
  17. package/docs/standard-result-outcome.md +165 -0
  18. package/env.example +44 -10
  19. package/eslint.config.mjs +101 -0
  20. package/netWatch.js +373 -222
  21. package/package.json +46 -31
  22. package/pour/README.md +47 -0
  23. package/pour/pour.min.js +8 -0
  24. package/procs/actDo.js +808 -0
  25. package/procs/catalog.d.ts +17 -0
  26. package/procs/catalog.js +313 -221
  27. package/procs/catalog.ts +398 -0
  28. package/procs/checkpoint.js +110 -0
  29. package/procs/config.d.ts +35 -0
  30. package/procs/config.js +63 -0
  31. package/procs/dateTime.js +2 -1
  32. package/procs/doActs.js +442 -849
  33. package/procs/doTestAct.js +27 -121
  34. package/procs/flow.js +221 -0
  35. package/procs/generateRuleRegistry.js +94 -0
  36. package/procs/getSource.d.ts +26 -0
  37. package/procs/getSource.js +1 -0
  38. package/procs/job.js +116 -1
  39. package/procs/launch.d.ts +40 -0
  40. package/procs/launch.js +239 -108
  41. package/procs/nu.d.ts +48 -0
  42. package/procs/nu.js +1 -0
  43. package/procs/scope.js +196 -0
  44. package/procs/shoot.d.ts +33 -0
  45. package/procs/shoot.js +3 -1
  46. package/procs/standard.d.ts +18 -0
  47. package/procs/standard.js +83 -0
  48. package/procs/standard.ts +126 -0
  49. package/procs/testAct.js +145 -0
  50. package/procs/testaro.d.ts +20 -0
  51. package/procs/testaro.js +237 -189
  52. package/procs/testaro.ts +321 -0
  53. package/procs/userPath.js +126 -0
  54. package/procs/xPath.d.ts +4 -0
  55. package/procs/xPath.js +82 -64
  56. package/procs/xPath.ts +106 -0
  57. package/procs/xPathScript.d.ts +6 -0
  58. package/procs/xPathScript.js +70 -0
  59. package/run.js +3 -2
  60. package/surea11y/README.md +44 -0
  61. package/surea11y/surea11y.browser.js +14 -0
  62. package/testaro/adbID.d.ts +3 -0
  63. package/testaro/adbID.js +39 -41
  64. package/testaro/adbID.ts +66 -0
  65. package/testaro/allCapStyle.d.ts +3 -0
  66. package/testaro/allCapStyle.js +32 -34
  67. package/testaro/allCapStyle.ts +55 -0
  68. package/testaro/allCaps.d.ts +16 -0
  69. package/testaro/allCaps.js +179 -151
  70. package/testaro/allCaps.ts +228 -0
  71. package/testaro/allHidden.d.ts +13 -0
  72. package/testaro/allHidden.js +30 -30
  73. package/testaro/allHidden.ts +50 -0
  74. package/testaro/allSlanted.d.ts +3 -0
  75. package/testaro/allSlanted.js +31 -33
  76. package/testaro/allSlanted.ts +54 -0
  77. package/testaro/altScheme.d.ts +3 -0
  78. package/testaro/altScheme.js +28 -30
  79. package/testaro/altScheme.ts +50 -0
  80. package/testaro/attVal.d.ts +3 -0
  81. package/testaro/attVal.js +21 -21
  82. package/testaro/attVal.ts +52 -0
  83. package/testaro/autocomplete.d.ts +3 -0
  84. package/testaro/autocomplete.js +60 -75
  85. package/testaro/autocomplete.ts +101 -0
  86. package/testaro/bulk.d.ts +13 -0
  87. package/testaro/bulk.js +33 -33
  88. package/testaro/bulk.ts +55 -0
  89. package/testaro/buttonMenu.d.ts +9 -0
  90. package/testaro/buttonMenu.js +318 -319
  91. package/testaro/buttonMenu.ts +391 -0
  92. package/testaro/captionLoc.d.ts +3 -0
  93. package/testaro/captionLoc.js +18 -20
  94. package/testaro/captionLoc.ts +40 -0
  95. package/testaro/datalistRef.d.ts +3 -0
  96. package/testaro/datalistRef.js +34 -36
  97. package/testaro/datalistRef.ts +55 -0
  98. package/testaro/distortion.d.ts +3 -0
  99. package/testaro/distortion.js +58 -26
  100. package/testaro/distortion.ts +81 -0
  101. package/testaro/docType.d.ts +15 -0
  102. package/testaro/docType.js +26 -25
  103. package/testaro/docType.ts +45 -0
  104. package/testaro/dupAtt.d.ts +16 -0
  105. package/testaro/dupAtt.js +114 -104
  106. package/testaro/dupAtt.ts +144 -0
  107. package/testaro/elements.d.ts +6 -0
  108. package/testaro/elements.js +153 -153
  109. package/testaro/elements.ts +215 -0
  110. package/testaro/embAc.d.ts +3 -0
  111. package/testaro/embAc.js +20 -20
  112. package/testaro/embAc.ts +40 -0
  113. package/testaro/focAll.d.ts +13 -0
  114. package/testaro/focAll.js +186 -191
  115. package/testaro/focAll.ts +217 -0
  116. package/testaro/focAndOp.d.ts +3 -0
  117. package/testaro/focAndOp.js +101 -104
  118. package/testaro/focAndOp.ts +128 -0
  119. package/testaro/focInd.d.ts +3 -0
  120. package/testaro/focInd.js +65 -66
  121. package/testaro/focInd.ts +96 -0
  122. package/testaro/focVis.d.ts +3 -0
  123. package/testaro/focVis.js +29 -30
  124. package/testaro/focVis.ts +52 -0
  125. package/testaro/headEl.d.ts +10 -0
  126. package/testaro/headEl.js +62 -62
  127. package/testaro/headEl.ts +82 -0
  128. package/testaro/headingAmb.d.ts +3 -0
  129. package/testaro/headingAmb.js +55 -63
  130. package/testaro/headingAmb.ts +72 -0
  131. package/testaro/hovInd.d.ts +12 -0
  132. package/testaro/hovInd.js +164 -130
  133. package/testaro/hovInd.ts +199 -0
  134. package/testaro/hover.d.ts +3 -0
  135. package/testaro/hover.js +156 -126
  136. package/testaro/hover.ts +154 -0
  137. package/testaro/hr.d.ts +3 -0
  138. package/testaro/hr.js +15 -17
  139. package/testaro/hr.ts +36 -0
  140. package/testaro/imageLink.d.ts +3 -0
  141. package/testaro/imageLink.js +18 -20
  142. package/testaro/imageLink.ts +42 -0
  143. package/testaro/labClash.d.ts +3 -0
  144. package/testaro/labClash.js +32 -33
  145. package/testaro/labClash.ts +54 -0
  146. package/testaro/legendLoc.d.ts +3 -0
  147. package/testaro/legendLoc.js +18 -20
  148. package/testaro/legendLoc.ts +42 -0
  149. package/testaro/lineHeight.d.ts +3 -0
  150. package/testaro/lineHeight.js +44 -48
  151. package/testaro/lineHeight.ts +70 -0
  152. package/testaro/linkAmb.d.ts +7 -0
  153. package/testaro/linkAmb.js +80 -80
  154. package/testaro/linkAmb.ts +105 -0
  155. package/testaro/linkExt.d.ts +3 -0
  156. package/testaro/linkExt.js +14 -16
  157. package/testaro/linkExt.ts +35 -0
  158. package/testaro/linkOldAtt.d.ts +3 -0
  159. package/testaro/linkOldAtt.js +26 -28
  160. package/testaro/linkOldAtt.ts +48 -0
  161. package/testaro/linkTo.d.ts +3 -0
  162. package/testaro/linkTo.js +23 -22
  163. package/testaro/linkTo.ts +43 -0
  164. package/testaro/linkUl.d.ts +3 -0
  165. package/testaro/linkUl.js +31 -34
  166. package/testaro/linkUl.ts +54 -0
  167. package/testaro/miniText.d.ts +3 -0
  168. package/testaro/miniText.js +42 -44
  169. package/testaro/miniText.ts +68 -0
  170. package/testaro/motion.d.ts +10 -0
  171. package/testaro/motion.js +93 -96
  172. package/testaro/motion.ts +125 -0
  173. package/testaro/nonTable.d.ts +3 -0
  174. package/testaro/nonTable.js +40 -45
  175. package/testaro/nonTable.ts +66 -0
  176. package/testaro/optRoleSel.d.ts +3 -0
  177. package/testaro/optRoleSel.js +17 -19
  178. package/testaro/optRoleSel.ts +41 -0
  179. package/testaro/phOnly.d.ts +3 -0
  180. package/testaro/phOnly.js +19 -21
  181. package/testaro/phOnly.ts +43 -0
  182. package/testaro/pseudoP.d.ts +3 -0
  183. package/testaro/pseudoP.js +37 -38
  184. package/testaro/pseudoP.ts +59 -0
  185. package/testaro/radioSet.d.ts +3 -0
  186. package/testaro/radioSet.js +58 -59
  187. package/testaro/radioSet.ts +79 -0
  188. package/testaro/registry.d.ts +63 -0
  189. package/testaro/registry.js +67 -0
  190. package/testaro/registry.ts +141 -0
  191. package/testaro/role.d.ts +3 -0
  192. package/testaro/role.js +28 -29
  193. package/testaro/role.ts +53 -0
  194. package/testaro/secHeading.d.ts +3 -0
  195. package/testaro/secHeading.js +31 -33
  196. package/testaro/secHeading.ts +53 -0
  197. package/testaro/styleDiff.d.ts +25 -0
  198. package/testaro/styleDiff.js +249 -252
  199. package/testaro/styleDiff.ts +303 -0
  200. package/testaro/tabNav.d.ts +33 -0
  201. package/testaro/tabNav.js +273 -342
  202. package/testaro/tabNav.ts +454 -0
  203. package/testaro/targetsNear.d.ts +9 -0
  204. package/testaro/targetsNear.js +131 -132
  205. package/testaro/targetsNear.ts +160 -0
  206. package/testaro/textNodes.d.ts +6 -0
  207. package/testaro/textNodes.js +139 -135
  208. package/testaro/textNodes.ts +185 -0
  209. package/testaro/textSem.d.ts +3 -0
  210. package/testaro/textSem.js +26 -28
  211. package/testaro/textSem.ts +47 -0
  212. package/testaro/title.d.ts +9 -0
  213. package/testaro/title.js +16 -13
  214. package/testaro/title.ts +31 -0
  215. package/testaro/titledEl.d.ts +3 -0
  216. package/testaro/titledEl.js +16 -18
  217. package/testaro/titledEl.ts +38 -0
  218. package/testaro/zIndex.d.ts +3 -0
  219. package/testaro/zIndex.js +20 -22
  220. package/testaro/zIndex.ts +42 -0
  221. package/tests/alfa.d.ts +45 -0
  222. package/tests/alfa.js +139 -141
  223. package/tests/alfa.ts +214 -0
  224. package/tests/aslint.d.ts +33 -0
  225. package/tests/aslint.js +273 -249
  226. package/tests/aslint.ts +301 -0
  227. package/tests/axe.d.ts +27 -0
  228. package/tests/axe.js +200 -200
  229. package/tests/axe.ts +277 -0
  230. package/tests/ed11y.d.ts +28 -0
  231. package/tests/ed11y.js +142 -99
  232. package/tests/ed11y.ts +178 -0
  233. package/tests/htmlcs.d.ts +21 -0
  234. package/tests/htmlcs.js +175 -140
  235. package/tests/htmlcs.ts +181 -0
  236. package/tests/ibm.d.ts +52 -0
  237. package/tests/ibm.js +165 -166
  238. package/tests/ibm.ts +251 -0
  239. package/tests/nuVal.d.ts +13 -0
  240. package/tests/nuVal.js +107 -112
  241. package/tests/nuVal.ts +145 -0
  242. package/tests/nuVnu.d.ts +15 -0
  243. package/tests/nuVnu.js +142 -111
  244. package/tests/nuVnu.ts +144 -0
  245. package/tests/pour.d.ts +31 -0
  246. package/tests/pour.js +242 -0
  247. package/tests/pour.ts +273 -0
  248. package/tests/qualWeb.d.ts +39 -0
  249. package/tests/qualWeb.js +303 -272
  250. package/tests/qualWeb.ts +415 -0
  251. package/tests/surea11y.d.ts +33 -0
  252. package/tests/surea11y.js +288 -0
  253. package/tests/surea11y.ts +334 -0
  254. package/tests/testaro.d.ts +25 -0
  255. package/tests/testaro.js +746 -652
  256. package/tests/testaro.ts +862 -0
  257. package/tests/wave.d.ts +46 -0
  258. package/tests/wave.js +167 -177
  259. package/tests/wave.ts +252 -0
  260. package/tsconfig.json +17 -0
  261. package/types.d.ts +243 -0
  262. package/types.js +10 -0
  263. package/types.ts +376 -0
  264. package/validation/act/README.md +46 -0
  265. package/validation/act/capture.js +424 -0
  266. package/validation/act/chromium-issue-draft.md +66 -0
  267. package/validation/act/fp-triage-2026-08-22.md +86 -0
  268. package/validation/act/isolation-notes.md +159 -0
  269. package/validation/act/playwright-issue-draft.md +73 -0
  270. package/validation/act/propose-mappings.js +0 -0
  271. package/validation/act/repro-cdp-raw.js +105 -0
  272. package/validation/act/repro-metarefresh.js +65 -0
  273. package/validation/act/score.js +184 -0
  274. package/validation/act/stage3a-stress-report.md +69 -0
  275. package/validation/act/stage3b-mapping-proposals.md +94 -0
  276. package/validation/act/stage3b-triage-draft.md +138 -0
  277. package/validation/act/surea11y-track-a-2026-09-01.md +50 -0
  278. package/validation/executors/netWatch.js +180 -90
  279. package/validation/executors/test.js +17 -2
  280. package/validation/executors/tests.js +118 -10
  281. package/validation/jobs/reports/raw/260901T1000-surea11y-validation.json +964 -0
  282. package/validation/jobs/todo/240101T1200-simple-example.json +14 -6
  283. package/validation/jobs/todo/240101T1300-shoot-example.json +2 -1
  284. package/validation/jobs/todo/260821T1900-pour-validation.json +45 -0
  285. package/validation/jobs/todo/260901T1000-surea11y-validation.json +45 -0
  286. package/validation/knownFailures.json +1 -0
  287. package/validation/tests/jobProperties/adbID.json +27 -2
  288. package/validation/tests/jobProperties/{focOp.json → allCapStyle.json} +56 -53
  289. package/validation/tests/jobProperties/allCaps.json +25 -0
  290. package/validation/tests/jobProperties/allHidden.json +133 -13
  291. package/validation/tests/jobProperties/allSlanted.json +3 -3
  292. package/validation/tests/jobProperties/altScheme.json +23 -8
  293. package/validation/tests/jobProperties/attVal.json +57 -57
  294. package/validation/tests/jobProperties/autocomplete.json +11 -1
  295. package/validation/tests/jobProperties/bulk.json +6 -1
  296. package/validation/tests/jobProperties/buttonMenu.json +63 -42
  297. package/validation/tests/jobProperties/captionLoc.json +1 -6
  298. package/validation/tests/jobProperties/checkpoint-browser.json +401 -0
  299. package/validation/tests/jobProperties/checkpoint-page.json +397 -0
  300. package/validation/tests/jobProperties/checkpoint.json +395 -0
  301. package/validation/tests/jobProperties/datalistRef.json +20 -5
  302. package/validation/tests/jobProperties/distortion.json +28 -3
  303. package/validation/tests/jobProperties/docType.json +2 -2
  304. package/validation/tests/jobProperties/dupAtt.json +48 -33
  305. package/validation/tests/jobProperties/elements.json +28 -28
  306. package/validation/tests/jobProperties/embAc.json +36 -31
  307. package/validation/tests/jobProperties/focAndOp.json +284 -0
  308. package/validation/tests/jobProperties/focInd.json +34 -34
  309. package/validation/tests/jobProperties/focVis.json +1 -1
  310. package/validation/tests/jobProperties/hover.json +39 -37
  311. package/validation/tests/jobProperties/hr.json +13 -3
  312. package/validation/tests/jobProperties/imageLink.json +0 -5
  313. package/validation/tests/jobProperties/labClash.json +68 -33
  314. package/validation/tests/jobProperties/legendLoc.json +1 -6
  315. package/validation/tests/jobProperties/lineHeight.json +2 -2
  316. package/validation/tests/jobProperties/linkAmb.json +13 -18
  317. package/validation/tests/jobProperties/linkExt.json +1 -1
  318. package/validation/tests/jobProperties/linkOldAtt.json +12 -2
  319. package/validation/tests/jobProperties/linkTo.json +1 -1
  320. package/validation/tests/jobProperties/linkUl.json +65 -65
  321. package/validation/tests/jobProperties/miniText.json +7 -2
  322. package/validation/tests/jobProperties/motion.json +4 -50
  323. package/validation/tests/jobProperties/nonTable.json +48 -3
  324. package/validation/tests/jobProperties/optRoleSel.json +12 -2
  325. package/validation/tests/jobProperties/phOnly.json +6 -16
  326. package/validation/tests/jobProperties/pseudoP.json +17 -2
  327. package/validation/tests/jobProperties/radioSet.json +30 -30
  328. package/validation/tests/jobProperties/role.json +25 -5
  329. package/validation/tests/jobProperties/secHeading.json +26 -21
  330. package/validation/tests/jobProperties/styleDiff.json +35 -5
  331. package/validation/tests/jobProperties/tabNav.json +3 -1
  332. package/validation/tests/jobProperties/targetsNear.json +237 -0
  333. package/validation/tests/jobProperties/textNodes.json +29 -29
  334. package/validation/tests/jobProperties/textSem.json +26 -1
  335. package/validation/tests/jobProperties/title.json +12 -2
  336. package/validation/tests/jobProperties/titledEl.json +39 -9
  337. package/validation/tests/jobProperties/userPath.json +317 -0
  338. package/validation/tests/jobProperties/zIndex.json +40 -35
  339. package/validation/tests/targets/allCapStyle/index.html +26 -0
  340. package/validation/tests/targets/checkpoint/index.html +38 -0
  341. package/validation/tests/targets/datalistRef/index.html +1 -1
  342. package/validation/tests/targets/focAndOp/bad.html +29 -0
  343. package/validation/tests/targets/{focOp → focAndOp}/good.html +3 -1
  344. package/validation/tests/targets/focInd/bad.html +2 -1
  345. package/validation/tests/targets/headEl/index.html +10 -1
  346. package/validation/tests/targets/{targetSmall → targetsNear}/index.html +15 -1
  347. package/validation/tests/targets/userPath/index.html +42 -0
  348. package/validation/validateTest.js +62 -10
  349. package/.claude/settings.local.json +0 -11
  350. package/.eslintrc.json +0 -41
  351. package/htmlcs/.eslintrc.json +0 -67
  352. package/memory/MEMORY.md +0 -3
  353. package/memory/project_validation_pause.md +0 -10
  354. package/validation/tests/jobProperties/linkTitle.json +0 -127
  355. package/validation/tests/jobProperties/opFoc.json +0 -164
  356. package/validation/tests/jobProperties/targetSmall.json +0 -152
  357. package/validation/tests/jobProperties/targetTiny.json +0 -142
  358. package/validation/tests/targets/focOp/bad.html +0 -25
  359. package/validation/tests/targets/linkTitle/index.html +0 -24
  360. package/validation/tests/targets/opFoc/bad.html +0 -26
  361. package/validation/tests/targets/opFoc/good.html +0 -23
package/testaro/hover.js CHANGED
@@ -1,145 +1,175 @@
1
+ "use strict";
1
2
  /*
2
3
  © 2021–2024 CVS Health and/or one of its affiliates. All rights reserved.
4
+ © 2026 Jeff Witt.
3
5
  © 2025–2026 Jonathan Robert Pool.
4
6
 
5
7
  Licensed under the MIT License. See LICENSE file at the project root or https://opensource.org/license/mit/ for details.
6
8
 
7
9
  SPDX-License-Identifier: MIT
8
10
  */
9
-
11
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
12
+ if (k2 === undefined) k2 = k;
13
+ var desc = Object.getOwnPropertyDescriptor(m, k);
14
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
15
+ desc = { enumerable: true, get: function() { return m[k]; } };
16
+ }
17
+ Object.defineProperty(o, k2, desc);
18
+ }) : (function(o, m, k, k2) {
19
+ if (k2 === undefined) k2 = k;
20
+ o[k2] = m[k];
21
+ }));
22
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
23
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
24
+ }) : function(o, v) {
25
+ o["default"] = v;
26
+ });
27
+ var __importStar = (this && this.__importStar) || (function () {
28
+ var ownKeys = function(o) {
29
+ ownKeys = Object.getOwnPropertyNames || function (o) {
30
+ var ar = [];
31
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
32
+ return ar;
33
+ };
34
+ return ownKeys(o);
35
+ };
36
+ return function (mod) {
37
+ if (mod && mod.__esModule) return mod;
38
+ var result = {};
39
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
40
+ __setModuleDefault(result, mod);
41
+ return result;
42
+ };
43
+ })();
44
+ Object.defineProperty(exports, "__esModule", { value: true });
45
+ exports.reporter = void 0;
46
+ const testaro_1 = require("../procs/testaro");
47
+ const playwright = __importStar(require("playwright"));
48
+ // Shared configuration for timeout multiplier.
49
+ const config_1 = require("../procs/config");
10
50
  /*
11
51
  hover
12
52
  This test reports unexpected impacts of hovering. The elements that are subjected to hovering (called “triggers”) include all the elements that have attributes associated with control over the visibility of other elements. If hovering over an element results in an increase or decrease in the total count of visible elements in the tree rooted in the grandparent of the trigger, the rule is considered violated. This test uses the getBasicResult function in order to use Playwright for the most realistic hover simulation.
53
+ Compiled to hover.js by tsc (issue #73); edit this file, not the emitted one.
13
54
  */
14
-
15
- // IMPORTS
16
-
17
- const {getBasicResult} = require('../procs/testaro');
18
- const playwright = require('playwright');
19
- // Shared configuration for timeout multiplier.
20
- const {applyMultiplier} = require('../procs/config');
21
-
22
55
  // FUNCTIONS
23
-
24
56
  // Returns an awaited change in a visible element count.
25
- const getVisibleCountChange = async (
26
- rootLoc, elementCount0, timeLimit = 400, settleInterval = 75
27
- ) => {
28
- const startTime = Date.now();
29
- let timeout;
30
- let settleChecker;
31
- let elementCount1 = elementCount0;
32
- // Set a time limit on the change.
33
- const timeoutPromise = new Promise(resolve => {
34
- timeout = setTimeout(() => {
35
- clearInterval(settleChecker);
36
- resolve();
37
- }, timeLimit);
38
- });
39
- // Until the time limit expires, periodically:
40
- const settlePromise = new Promise(resolve => {
41
- settleChecker = setInterval(async () => {
42
- const visiblesLoc = await rootLoc.locator('*:visible');
43
- // Get the count.
44
- elementCount1 = await visiblesLoc.count();
45
- // If the count has changed:
46
- if (elementCount1 !== elementCount0) {
47
- // Stop.
48
- clearTimeout(timeout);
49
- clearInterval(settleChecker);
50
- resolve();
51
- }
52
- }, settleInterval);
53
- });
54
- // When a change occurs or the time limit expires:
55
- await Promise.race([timeoutPromise, settlePromise]);
56
- const elapsedTime = Math.round(Date.now() - startTime);
57
- // Return the change.
58
- return {
59
- change: elementCount1 - elementCount0,
60
- elapsedTime
61
- };
57
+ const getVisibleCountChange = async (rootLoc, elementCount0, timeLimit = 400, settleInterval = 75) => {
58
+ const startTime = Date.now();
59
+ let timeout;
60
+ let settleChecker;
61
+ let elementCount1 = elementCount0;
62
+ // Set a time limit on the change.
63
+ const timeoutPromise = new Promise(resolve => {
64
+ timeout = setTimeout(() => {
65
+ clearInterval(settleChecker);
66
+ resolve();
67
+ }, timeLimit);
68
+ });
69
+ // Until the time limit expires, periodically:
70
+ const settlePromise = new Promise(resolve => {
71
+ settleChecker = setInterval(async () => {
72
+ const visiblesLoc = await rootLoc.locator('*:visible');
73
+ // Get the count.
74
+ elementCount1 = await visiblesLoc.count();
75
+ // If the count has changed:
76
+ if (elementCount1 !== elementCount0) {
77
+ // Stop.
78
+ clearTimeout(timeout);
79
+ clearInterval(settleChecker);
80
+ resolve();
81
+ }
82
+ }, settleInterval);
83
+ });
84
+ // When a change occurs or the time limit expires:
85
+ await Promise.race([timeoutPromise, settlePromise]);
86
+ const elapsedTime = Math.round(Date.now() - startTime);
87
+ // Return the change.
88
+ return {
89
+ change: elementCount1 - elementCount0,
90
+ elapsedTime
91
+ };
62
92
  };
63
93
  // Gets a violation description.
64
- const getViolationDescription = (change, elapsedTime) =>
65
- `Hovering over the element changes the related visible element count by ${change} in ${elapsedTime}ms`;
94
+ const getViolationDescription = (change, elapsedTime) => `Hovering over the element changes the related visible element count by ${change} in ${elapsedTime}ms`;
66
95
  // Runs the test and returns the result.
67
- exports.reporter = async (page, report, _, withItems) => {
68
- // Initialize the locators and result.
69
- const candidateLocs = await page.locator([
70
- '[aria-controls]:visible',
71
- '[aria-expanded]:visible',
72
- '[aria-haspopup]:visible',
73
- '[onmouseenter]:visible',
74
- '[onmouseover]:visible',
75
- '[onpointerenter]:visible',
76
- '[onpointerover]:visible',
77
- '[role="menu"]:visible',
78
- '[role="menubar"]:visible',
79
- '[role="menuitem"]:visible',
80
- '[data-tooltip]:visible',
81
- '[data-popover]:visible',
82
- '[data-hover]:visible',
83
- '[data-menu]:visible',
84
- '[data-dropdown]:visible',
85
- '[role=tab]:visible',
86
- '[role=combobox]:visible'
87
- ].join(', '));
88
- const allLocs = await candidateLocs.all();
89
- const violations = [];
90
- const data = {
91
- hoverableCount: allLocs.length
92
- };
93
- // For each locator:
94
- for (const loc of allLocs) {
95
- // Get the XPath of the element referenced by the locator.
96
- let xPath = await loc.evaluate(element => getXPath(element));
97
- const pathSegments = xPath.split('/');
98
- const {length} = pathSegments;
99
- // Change it to the XPath of the desired observation root.
100
- pathSegments.pop();
101
- if (! ['main', 'body'].includes(pathSegments[length - 2])) {
102
- pathSegments.pop();
103
- }
104
- xPath = pathSegments.join('/');
105
- // Get a locator for the observation root.
106
- const rootLoc = page.locator(`xpath=${xPath}`);
107
- const loc0 = await rootLoc.locator('*:visible');
108
- // Get a pre-hover count of the visible elements in the observation tree.
109
- const elementCount0 = await loc0.count();
110
- try {
111
- // Hover over the element.
112
- await loc.hover({timeout: applyMultiplier(400)});
113
- // Get the change in the count of the visible elements in the observation tree.
114
- const changeData = await getVisibleCountChange(rootLoc, elementCount0, 400, 75);
115
- const {change, elapsedTime} = changeData;
116
- // If a change occurred:
117
- if (change) {
118
- // Add the locator and a violation description to the array of violations.
119
- violations.push({
120
- loc,
121
- what: getViolationDescription(change, elapsedTime)
122
- });
123
- }
124
- // Stop hovering over the element.
125
- await page.mouse.move(0, 0);
126
- // Await a reverse change in the count of the visible elements in the observation tree.
127
- await getVisibleCountChange(rootLoc, elementCount0 + change);
128
- }
129
- // If hovering throws an error:
130
- catch(error) {
131
- // If the error is a timeout:
132
- if (error instanceof playwright.errors.TimeoutError) {
133
- // Skip the locator.
134
- continue;
135
- }
136
- // Otherwise, i.e. if the error is not a timeout, report this and quit.
137
- data.prevented = true;
138
- data.error = `ERROR hovering over an element (${error.message.slice(0, 200)})`;
139
- break;
96
+ const reporter = async (page, report, _, withItems) => {
97
+ // Initialize the locators and result.
98
+ const candidateLocs = await page.locator([
99
+ '[aria-controls]:visible',
100
+ '[aria-expanded]:visible',
101
+ '[aria-haspopup]:visible',
102
+ '[onmouseenter]:visible',
103
+ '[onmouseover]:visible',
104
+ '[onpointerenter]:visible',
105
+ '[onpointerover]:visible',
106
+ '[role="menu"]:visible',
107
+ '[role="menubar"]:visible',
108
+ '[role="menuitem"]:visible',
109
+ '[data-tooltip]:visible',
110
+ '[data-popover]:visible',
111
+ '[data-hover]:visible',
112
+ '[data-menu]:visible',
113
+ '[data-dropdown]:visible',
114
+ '[role=tab]:visible',
115
+ '[role=combobox]:visible'
116
+ ].join(', '));
117
+ const allLocs = await candidateLocs.all();
118
+ const violations = [];
119
+ const data = {
120
+ hoverableCount: allLocs.length
121
+ };
122
+ // For each locator:
123
+ for (const loc of allLocs) {
124
+ // Get the XPath of the element referenced by the locator.
125
+ let xPath = (await loc.evaluate(element => getXPath(element)));
126
+ const pathSegments = xPath.split('/');
127
+ const { length } = pathSegments;
128
+ // Change it to the XPath of the desired observation root.
129
+ pathSegments.pop();
130
+ if (!['main', 'body'].includes(pathSegments[length - 2])) {
131
+ pathSegments.pop();
132
+ }
133
+ xPath = pathSegments.join('/');
134
+ // Get a locator for the observation root.
135
+ const rootLoc = page.locator(`xpath=${xPath}`);
136
+ const loc0 = await rootLoc.locator('*:visible');
137
+ // Get a pre-hover count of the visible elements in the observation tree.
138
+ const elementCount0 = await loc0.count();
139
+ try {
140
+ // Hover over the element.
141
+ await loc.hover({ timeout: (0, config_1.applyMultiplier)(400) });
142
+ // Get the change in the count of the visible elements in the observation tree.
143
+ const changeData = await getVisibleCountChange(rootLoc, elementCount0, 400, 75);
144
+ const { change, elapsedTime } = changeData;
145
+ // If a change occurred:
146
+ if (change) {
147
+ // Add the locator and a violation description to the array of violations.
148
+ violations.push({
149
+ loc,
150
+ what: getViolationDescription(change, elapsedTime)
151
+ });
152
+ }
153
+ // Stop hovering over the element.
154
+ await page.mouse.move(0, 0);
155
+ // Await a reverse change in the count of the visible elements in the observation tree.
156
+ await getVisibleCountChange(rootLoc, elementCount0 + change);
157
+ }
158
+ // If hovering throws an error:
159
+ catch (error) {
160
+ // If the error is a timeout:
161
+ if (error instanceof playwright.errors.TimeoutError) {
162
+ // Skip the locator.
163
+ continue;
164
+ }
165
+ // Otherwise, i.e. if the error is not a timeout, report this and quit.
166
+ data.prevented = true;
167
+ data.error = `ERROR hovering over an element (${error.message.slice(0, 200)})`;
168
+ break;
169
+ }
140
170
  }
141
- }
142
- // Get and return a result.
143
- const whats = 'Hovering over elements changes the number of related visible elements';
144
- return await getBasicResult(report, withItems, 'hover', 0, whats, data, violations);
171
+ // Get and return a result.
172
+ const whats = 'Hovering over elements changes the number of related visible elements';
173
+ return await (0, testaro_1.getBasicResult)(report, withItems, 'hover', 0, whats, data, violations);
145
174
  };
175
+ exports.reporter = reporter;
@@ -0,0 +1,154 @@
1
+ /*
2
+ © 2021–2024 CVS Health and/or one of its affiliates. All rights reserved.
3
+ © 2026 Jeff Witt.
4
+ © 2025–2026 Jonathan Robert Pool.
5
+
6
+ Licensed under the MIT License. See LICENSE file at the project root or https://opensource.org/license/mit/ for details.
7
+
8
+ SPDX-License-Identifier: MIT
9
+ */
10
+
11
+ // IMPORTS
12
+
13
+ import type {Locator, Page} from 'playwright';
14
+ import {getBasicResult} from '../procs/testaro';
15
+ import type {Report} from '../types';
16
+ import * as playwright from 'playwright';
17
+ // Shared configuration for timeout multiplier.
18
+ import {applyMultiplier} from '../procs/config';
19
+
20
+ // TYPES
21
+
22
+ // The injected getXPath is reached as a bare page global inside locator evaluate callbacks.
23
+ declare const getXPath: Window['getXPath'];
24
+
25
+ /*
26
+ hover
27
+ This test reports unexpected impacts of hovering. The elements that are subjected to hovering (called “triggers”) include all the elements that have attributes associated with control over the visibility of other elements. If hovering over an element results in an increase or decrease in the total count of visible elements in the tree rooted in the grandparent of the trigger, the rule is considered violated. This test uses the getBasicResult function in order to use Playwright for the most realistic hover simulation.
28
+ Compiled to hover.js by tsc (issue #73); edit this file, not the emitted one.
29
+ */
30
+
31
+ // FUNCTIONS
32
+
33
+ // Returns an awaited change in a visible element count.
34
+ const getVisibleCountChange = async (
35
+ rootLoc: Locator, elementCount0: number, timeLimit = 400, settleInterval = 75
36
+ ) => {
37
+ const startTime = Date.now();
38
+ let timeout: NodeJS.Timeout;
39
+ let settleChecker: NodeJS.Timeout;
40
+ let elementCount1 = elementCount0;
41
+ // Set a time limit on the change.
42
+ const timeoutPromise = new Promise<void>(resolve => {
43
+ timeout = setTimeout(() => {
44
+ clearInterval(settleChecker);
45
+ resolve();
46
+ }, timeLimit);
47
+ });
48
+ // Until the time limit expires, periodically:
49
+ const settlePromise = new Promise<void>(resolve => {
50
+ settleChecker = setInterval(async () => {
51
+ const visiblesLoc = await rootLoc.locator('*:visible');
52
+ // Get the count.
53
+ elementCount1 = await visiblesLoc.count();
54
+ // If the count has changed:
55
+ if (elementCount1 !== elementCount0) {
56
+ // Stop.
57
+ clearTimeout(timeout);
58
+ clearInterval(settleChecker);
59
+ resolve();
60
+ }
61
+ }, settleInterval);
62
+ });
63
+ // When a change occurs or the time limit expires:
64
+ await Promise.race([timeoutPromise, settlePromise]);
65
+ const elapsedTime = Math.round(Date.now() - startTime);
66
+ // Return the change.
67
+ return {
68
+ change: elementCount1 - elementCount0,
69
+ elapsedTime
70
+ };
71
+ };
72
+ // Gets a violation description.
73
+ const getViolationDescription = (change: number, elapsedTime: number) =>
74
+ `Hovering over the element changes the related visible element count by ${change} in ${elapsedTime}ms`;
75
+ // Runs the test and returns the result.
76
+ export const reporter = async (page: Page, report: Report, _: unknown, withItems: boolean) => {
77
+ // Initialize the locators and result.
78
+ const candidateLocs = await page.locator([
79
+ '[aria-controls]:visible',
80
+ '[aria-expanded]:visible',
81
+ '[aria-haspopup]:visible',
82
+ '[onmouseenter]:visible',
83
+ '[onmouseover]:visible',
84
+ '[onpointerenter]:visible',
85
+ '[onpointerover]:visible',
86
+ '[role="menu"]:visible',
87
+ '[role="menubar"]:visible',
88
+ '[role="menuitem"]:visible',
89
+ '[data-tooltip]:visible',
90
+ '[data-popover]:visible',
91
+ '[data-hover]:visible',
92
+ '[data-menu]:visible',
93
+ '[data-dropdown]:visible',
94
+ '[role=tab]:visible',
95
+ '[role=combobox]:visible'
96
+ ].join(', '));
97
+ const allLocs = await candidateLocs.all();
98
+ const violations: {loc: Locator; what: string}[] = [];
99
+ const data: {hoverableCount: number; prevented?: boolean; error?: string} = {
100
+ hoverableCount: allLocs.length
101
+ };
102
+ // For each locator:
103
+ for (const loc of allLocs) {
104
+ // Get the XPath of the element referenced by the locator.
105
+ let xPath = (await loc.evaluate(element => getXPath(element)))!;
106
+ const pathSegments = xPath.split('/');
107
+ const {length} = pathSegments;
108
+ // Change it to the XPath of the desired observation root.
109
+ pathSegments.pop();
110
+ if (! ['main', 'body'].includes(pathSegments[length - 2])) {
111
+ pathSegments.pop();
112
+ }
113
+ xPath = pathSegments.join('/');
114
+ // Get a locator for the observation root.
115
+ const rootLoc = page.locator(`xpath=${xPath}`);
116
+ const loc0 = await rootLoc.locator('*:visible');
117
+ // Get a pre-hover count of the visible elements in the observation tree.
118
+ const elementCount0 = await loc0.count();
119
+ try {
120
+ // Hover over the element.
121
+ await loc.hover({timeout: applyMultiplier(400)});
122
+ // Get the change in the count of the visible elements in the observation tree.
123
+ const changeData = await getVisibleCountChange(rootLoc, elementCount0, 400, 75);
124
+ const {change, elapsedTime} = changeData;
125
+ // If a change occurred:
126
+ if (change) {
127
+ // Add the locator and a violation description to the array of violations.
128
+ violations.push({
129
+ loc,
130
+ what: getViolationDescription(change, elapsedTime)
131
+ });
132
+ }
133
+ // Stop hovering over the element.
134
+ await page.mouse.move(0, 0);
135
+ // Await a reverse change in the count of the visible elements in the observation tree.
136
+ await getVisibleCountChange(rootLoc, elementCount0 + change);
137
+ }
138
+ // If hovering throws an error:
139
+ catch(error) {
140
+ // If the error is a timeout:
141
+ if (error instanceof playwright.errors.TimeoutError) {
142
+ // Skip the locator.
143
+ continue;
144
+ }
145
+ // Otherwise, i.e. if the error is not a timeout, report this and quit.
146
+ data.prevented = true;
147
+ data.error = `ERROR hovering over an element (${(error as Error).message.slice(0, 200)})`;
148
+ break;
149
+ }
150
+ }
151
+ // Get and return a result.
152
+ const whats = 'Hovering over elements changes the number of related visible elements';
153
+ return await getBasicResult(report, withItems, 'hover', 0, whats, data, violations);
154
+ };
@@ -0,0 +1,3 @@
1
+ import type { Page } from 'playwright';
2
+ import type { Report } from '../types';
3
+ export declare const reporter: (page: Page, report: Report, _: unknown, withItems: boolean) => Promise<import("../procs/testaro").RuleResult>;
package/testaro/hr.js CHANGED
@@ -1,5 +1,7 @@
1
+ "use strict";
1
2
  /*
2
3
  © 2023–2024 CVS Health and/or one of its affiliates. All rights reserved.
4
+ © 2026 Jeff Witt.
3
5
  © 2025–2026 Jonathan Robert Pool.
4
6
 
5
7
  Licensed under the MIT License. See LICENSE file at the project root or
@@ -7,26 +9,22 @@
7
9
 
8
10
  SPDX-License-Identifier: MIT
9
11
  */
10
-
12
+ Object.defineProperty(exports, "__esModule", { value: true });
13
+ exports.reporter = void 0;
14
+ const testaro_1 = require("../procs/testaro");
11
15
  /*
12
16
  hr
13
- This test reports the use of hr elements.
17
+ This test reports the use of hr elements. Compiled to hr.js by tsc (issue #73); edit this
18
+ file, not the emitted one.
14
19
  */
15
-
16
- // IMPORTS
17
-
18
- const {doTest} = require('../procs/testaro');
19
-
20
20
  // FUNCTIONS
21
-
22
21
  // Runs the test and returns the result.
23
- exports.reporter = async (page, report, _, withItems) => {
24
- const getBadWhat = element => {
25
- // Return a violation description.
26
- return `hr element is used for vertical segmentation`;
27
- }
28
- const whats = 'HR elements are used for vertical segmentation';
29
- return await doTest(
30
- page, report, withItems, 'hr', 'body hr', whats, 0, getBadWhat.toString()
31
- );
22
+ const reporter = async (page, report, _, withItems) => {
23
+ const getBadWhat = element => {
24
+ // Return a violation description.
25
+ return `hr element is used for vertical segmentation`;
26
+ };
27
+ const whats = 'HR elements are used for vertical segmentation';
28
+ return await (0, testaro_1.doTest)(page, report, withItems, 'hr', 'body hr', whats, 0, getBadWhat.toString());
32
29
  };
30
+ exports.reporter = reporter;
package/testaro/hr.ts ADDED
@@ -0,0 +1,36 @@
1
+ /*
2
+ © 2023–2024 CVS Health and/or one of its affiliates. All rights reserved.
3
+ © 2026 Jeff Witt.
4
+ © 2025–2026 Jonathan Robert Pool.
5
+
6
+ Licensed under the MIT License. See LICENSE file at the project root or
7
+ https://opensource.org/license/mit/ for details.
8
+
9
+ SPDX-License-Identifier: MIT
10
+ */
11
+
12
+ // IMPORTS
13
+
14
+ import type {Page} from 'playwright';
15
+ import {doTest} from '../procs/testaro';
16
+ import type {GetBadWhat, Report} from '../types';
17
+
18
+ /*
19
+ hr
20
+ This test reports the use of hr elements. Compiled to hr.js by tsc (issue #73); edit this
21
+ file, not the emitted one.
22
+ */
23
+
24
+ // FUNCTIONS
25
+
26
+ // Runs the test and returns the result.
27
+ export const reporter = async (page: Page, report: Report, _: unknown, withItems: boolean) => {
28
+ const getBadWhat: GetBadWhat = element => {
29
+ // Return a violation description.
30
+ return `hr element is used for vertical segmentation`;
31
+ }
32
+ const whats = 'HR elements are used for vertical segmentation';
33
+ return await doTest(
34
+ page, report, withItems, 'hr', 'body hr', whats, 0, getBadWhat.toString()
35
+ );
36
+ };
@@ -0,0 +1,3 @@
1
+ import type { Page } from 'playwright';
2
+ import type { Report } from '../types';
3
+ export declare const reporter: (page: Page, report: Report, _: unknown, withItems: boolean) => Promise<import("../procs/testaro").RuleResult>;
@@ -1,6 +1,8 @@
1
+ "use strict";
1
2
  /*
2
3
  © 2025 CVS Health and/or one of its affiliates. All rights reserved.
3
4
  © 2025 Juan S. Casado.
5
+ © 2026 Jeff Witt.
4
6
  © 2025–2026 Jonathan Robert Pool
5
7
 
6
8
  Licensed under the MIT License. See LICENSE file at the project root or
@@ -8,31 +10,27 @@
8
10
 
9
11
  SPDX-License-Identifier: MIT
10
12
  */
11
-
13
+ Object.defineProperty(exports, "__esModule", { value: true });
14
+ exports.reporter = void 0;
15
+ const testaro_1 = require("../procs/testaro");
12
16
  /*
13
17
  imageLink
14
18
  Clean-room rule.
15
19
  This test reports links whose destinations are image files.
20
+ Compiled to imageLink.js by tsc (issue #73); edit this file, not the emitted one.
16
21
  */
17
-
18
- // IMPORTS
19
-
20
- const {doTest} = require('../procs/testaro');
21
-
22
22
  // FUNCTIONS
23
-
24
23
  // Runs the test and returns the result.
25
- exports.reporter = async (page, report, _, withItems) => {
26
- const getBadWhat = element => {
27
- const href = element.getAttribute('href') || '';
28
- // If the destination of the element is an image file:
29
- if (/\.(?:png|jpe?g|gif|svg|webp|ico)(?:$|[?#])/i.test(href)) {
30
- // Return a violation description.
31
- return 'Link destination is an image file';
32
- }
33
- };
34
- const whats = 'Links have image files as their destinations';
35
- return await doTest(
36
- page, report, withItems, 'imageLink', 'body a[href]', whats, 0, getBadWhat.toString()
37
- );
24
+ const reporter = async (page, report, _, withItems) => {
25
+ const getBadWhat = element => {
26
+ const href = element.getAttribute('href') || '';
27
+ // If the destination of the element is an image file:
28
+ if (/\.(?:png|jpe?g|gif|svg|webp|ico)(?:$|[?#])/i.test(href)) {
29
+ // Return a violation description.
30
+ return 'Link destination is an image file';
31
+ }
32
+ };
33
+ const whats = 'Links have image files as their destinations';
34
+ return await (0, testaro_1.doTest)(page, report, withItems, 'imageLink', 'body a[href]', whats, 0, getBadWhat.toString());
38
35
  };
36
+ exports.reporter = reporter;
@@ -0,0 +1,42 @@
1
+ /*
2
+ © 2025 CVS Health and/or one of its affiliates. All rights reserved.
3
+ © 2025 Juan S. Casado.
4
+ © 2026 Jeff Witt.
5
+ © 2025–2026 Jonathan Robert Pool
6
+
7
+ Licensed under the MIT License. See LICENSE file at the project root or
8
+ https://opensource.org/license/mit/ for details.
9
+
10
+ SPDX-License-Identifier: MIT
11
+ */
12
+
13
+ // IMPORTS
14
+
15
+ import type {Page} from 'playwright';
16
+ import {doTest} from '../procs/testaro';
17
+ import type {GetBadWhat, Report} from '../types';
18
+
19
+ /*
20
+ imageLink
21
+ Clean-room rule.
22
+ This test reports links whose destinations are image files.
23
+ Compiled to imageLink.js by tsc (issue #73); edit this file, not the emitted one.
24
+ */
25
+
26
+ // FUNCTIONS
27
+
28
+ // Runs the test and returns the result.
29
+ export const reporter = async (page: Page, report: Report, _: unknown, withItems: boolean) => {
30
+ const getBadWhat: GetBadWhat = element => {
31
+ const href = element.getAttribute('href') || '';
32
+ // If the destination of the element is an image file:
33
+ if (/\.(?:png|jpe?g|gif|svg|webp|ico)(?:$|[?#])/i.test(href)) {
34
+ // Return a violation description.
35
+ return 'Link destination is an image file';
36
+ }
37
+ };
38
+ const whats = 'Links have image files as their destinations';
39
+ return await doTest(
40
+ page, report, withItems, 'imageLink', 'body a[href]', whats, 0, getBadWhat.toString()
41
+ );
42
+ };
@@ -0,0 +1,3 @@
1
+ import type { Page } from 'playwright';
2
+ import type { Report } from '../types';
3
+ export declare const reporter: (page: Page, report: Report, _: unknown, withItems: boolean) => Promise<import("../procs/testaro").RuleResult>;