@selenium/atoms 4.51.0 → 4.52.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 (331) hide show
  1. package/dist/index.d.ts +40 -0
  2. package/dist/index.d.ts.map +1 -1
  3. package/dist/index.js +40 -0
  4. package/dist/index.js.map +1 -1
  5. package/dist/typescript/active-element.d.ts +2 -0
  6. package/dist/typescript/active-element.d.ts.map +1 -0
  7. package/dist/typescript/active-element.js +19 -0
  8. package/dist/typescript/active-element.js.map +1 -0
  9. package/dist/typescript/clear-local-storage.d.ts +3 -0
  10. package/dist/typescript/clear-local-storage.d.ts.map +1 -0
  11. package/dist/typescript/clear-local-storage.js +25 -0
  12. package/dist/typescript/clear-local-storage.js.map +1 -0
  13. package/dist/typescript/clear-session-storage.d.ts +3 -0
  14. package/dist/typescript/clear-session-storage.d.ts.map +1 -0
  15. package/dist/typescript/clear-session-storage.js +25 -0
  16. package/dist/typescript/clear-session-storage.js.map +1 -0
  17. package/dist/typescript/clear.d.ts +3 -0
  18. package/dist/typescript/clear.d.ts.map +1 -0
  19. package/dist/typescript/clear.js +67 -0
  20. package/dist/typescript/clear.js.map +1 -0
  21. package/dist/typescript/click.d.ts +4 -0
  22. package/dist/typescript/click.d.ts.map +1 -0
  23. package/dist/typescript/click.js +52 -0
  24. package/dist/typescript/click.js.map +1 -0
  25. package/dist/typescript/core/attribute.d.ts +3 -0
  26. package/dist/typescript/core/attribute.d.ts.map +1 -0
  27. package/dist/typescript/core/attribute.js +60 -0
  28. package/dist/typescript/core/attribute.js.map +1 -0
  29. package/dist/typescript/core/color.d.ts +2 -0
  30. package/dist/typescript/core/color.d.ts.map +1 -0
  31. package/dist/typescript/core/color.js +248 -0
  32. package/dist/typescript/core/color.js.map +1 -0
  33. package/dist/typescript/core/editable.d.ts +5 -0
  34. package/dist/typescript/core/editable.d.ts.map +1 -0
  35. package/dist/typescript/core/editable.js +55 -0
  36. package/dist/typescript/core/editable.js.map +1 -0
  37. package/dist/typescript/core/element.d.ts +6 -0
  38. package/dist/typescript/core/element.d.ts.map +1 -0
  39. package/dist/typescript/core/element.js +97 -0
  40. package/dist/typescript/core/element.js.map +1 -0
  41. package/dist/typescript/core/enabled.d.ts +2 -0
  42. package/dist/typescript/core/enabled.d.ts.map +1 -0
  43. package/dist/typescript/core/enabled.js +69 -0
  44. package/dist/typescript/core/enabled.js.map +1 -0
  45. package/dist/typescript/core/error.d.ts +13 -0
  46. package/dist/typescript/core/error.d.ts.map +1 -0
  47. package/dist/typescript/core/error.js +40 -0
  48. package/dist/typescript/core/error.js.map +1 -0
  49. package/dist/typescript/core/events.d.ts +91 -0
  50. package/dist/typescript/core/events.d.ts.map +1 -0
  51. package/dist/typescript/core/events.js +131 -0
  52. package/dist/typescript/core/events.js.map +1 -0
  53. package/dist/typescript/core/focus.d.ts +4 -0
  54. package/dist/typescript/core/focus.d.ts.map +1 -0
  55. package/dist/typescript/core/focus.js +88 -0
  56. package/dist/typescript/core/focus.js.map +1 -0
  57. package/dist/typescript/core/focusable.d.ts +2 -0
  58. package/dist/typescript/core/focusable.d.ts.map +1 -0
  59. package/dist/typescript/core/focusable.js +36 -0
  60. package/dist/typescript/core/focusable.js.map +1 -0
  61. package/dist/typescript/core/form.d.ts +2 -0
  62. package/dist/typescript/core/form.d.ts.map +1 -0
  63. package/dist/typescript/core/form.js +76 -0
  64. package/dist/typescript/core/form.js.map +1 -0
  65. package/dist/typescript/core/frame.d.ts +8 -0
  66. package/dist/typescript/core/frame.d.ts.map +1 -0
  67. package/dist/typescript/core/frame.js +95 -0
  68. package/dist/typescript/core/frame.js.map +1 -0
  69. package/dist/typescript/core/geometry.d.ts +28 -0
  70. package/dist/typescript/core/geometry.d.ts.map +1 -0
  71. package/dist/typescript/core/geometry.js +134 -0
  72. package/dist/typescript/core/geometry.js.map +1 -0
  73. package/dist/typescript/core/inject.d.ts +21 -0
  74. package/dist/typescript/core/inject.d.ts.map +1 -0
  75. package/dist/typescript/core/inject.js +282 -0
  76. package/dist/typescript/core/inject.js.map +1 -0
  77. package/dist/typescript/core/interactable.d.ts +2 -0
  78. package/dist/typescript/core/interactable.d.ts.map +1 -0
  79. package/dist/typescript/core/interactable.js +27 -0
  80. package/dist/typescript/core/interactable.js.map +1 -0
  81. package/dist/typescript/core/keyboard.d.ts +15 -0
  82. package/dist/typescript/core/keyboard.d.ts.map +1 -0
  83. package/dist/typescript/core/keyboard.js +356 -0
  84. package/dist/typescript/core/keyboard.js.map +1 -0
  85. package/dist/typescript/core/keys.d.ts +65 -0
  86. package/dist/typescript/core/keys.d.ts.map +1 -0
  87. package/dist/typescript/core/keys.js +125 -0
  88. package/dist/typescript/core/keys.js.map +1 -0
  89. package/dist/typescript/core/locators.d.ts +6 -0
  90. package/dist/typescript/core/locators.d.ts.map +1 -0
  91. package/dist/typescript/core/locators.js +610 -0
  92. package/dist/typescript/core/locators.js.map +1 -0
  93. package/dist/typescript/core/mouse.d.ts +17 -0
  94. package/dist/typescript/core/mouse.d.ts.map +1 -0
  95. package/dist/typescript/core/mouse.js +186 -0
  96. package/dist/typescript/core/mouse.js.map +1 -0
  97. package/dist/typescript/core/overflow.d.ts +5 -0
  98. package/dist/typescript/core/overflow.d.ts.map +1 -0
  99. package/dist/typescript/core/overflow.js +133 -0
  100. package/dist/typescript/core/overflow.js.map +1 -0
  101. package/dist/typescript/core/scroll.d.ts +3 -0
  102. package/dist/typescript/core/scroll.d.ts.map +1 -0
  103. package/dist/typescript/core/scroll.js +77 -0
  104. package/dist/typescript/core/scroll.js.map +1 -0
  105. package/dist/typescript/core/shown.d.ts +3 -0
  106. package/dist/typescript/core/shown.d.ts.map +1 -0
  107. package/dist/typescript/core/shown.js +190 -0
  108. package/dist/typescript/core/shown.js.map +1 -0
  109. package/dist/typescript/core/storage.d.ts +14 -0
  110. package/dist/typescript/core/storage.d.ts.map +1 -0
  111. package/dist/typescript/core/storage.js +98 -0
  112. package/dist/typescript/core/storage.js.map +1 -0
  113. package/dist/typescript/core/style.d.ts +2 -0
  114. package/dist/typescript/core/style.d.ts.map +1 -0
  115. package/dist/typescript/core/style.js +32 -0
  116. package/dist/typescript/core/style.js.map +1 -0
  117. package/dist/typescript/core/useragent.d.ts +3 -0
  118. package/dist/typescript/core/useragent.d.ts.map +1 -0
  119. package/dist/typescript/core/useragent.js +31 -0
  120. package/dist/typescript/core/useragent.js.map +1 -0
  121. package/dist/typescript/default-content.d.ts +2 -0
  122. package/dist/typescript/default-content.d.ts.map +1 -0
  123. package/dist/typescript/default-content.js +20 -0
  124. package/dist/typescript/default-content.js.map +1 -0
  125. package/dist/typescript/execute-async-script.d.ts +2 -0
  126. package/dist/typescript/execute-async-script.d.ts.map +1 -0
  127. package/dist/typescript/execute-async-script.js +20 -0
  128. package/dist/typescript/execute-async-script.js.map +1 -0
  129. package/dist/typescript/execute-script.d.ts +2 -0
  130. package/dist/typescript/execute-script.d.ts.map +1 -0
  131. package/dist/typescript/execute-script.js +20 -0
  132. package/dist/typescript/execute-script.js.map +1 -0
  133. package/dist/typescript/find-element-fragment.d.ts +8 -0
  134. package/dist/typescript/find-element-fragment.d.ts.map +1 -0
  135. package/dist/typescript/find-element-fragment.js +39 -0
  136. package/dist/typescript/find-element-fragment.js.map +1 -0
  137. package/dist/typescript/find-element.d.ts +2 -0
  138. package/dist/typescript/find-element.d.ts.map +1 -0
  139. package/dist/typescript/find-element.js +18 -0
  140. package/dist/typescript/find-element.js.map +1 -0
  141. package/dist/typescript/find-elements.d.ts +1 -2
  142. package/dist/typescript/find-elements.d.ts.map +1 -1
  143. package/dist/typescript/find-elements.js +1 -289
  144. package/dist/typescript/find-elements.js.map +1 -1
  145. package/dist/typescript/frame-by-id-or-name.d.ts +2 -0
  146. package/dist/typescript/frame-by-id-or-name.d.ts.map +1 -0
  147. package/dist/typescript/frame-by-id-or-name.js +22 -0
  148. package/dist/typescript/frame-by-id-or-name.js.map +1 -0
  149. package/dist/typescript/frame-by-index.d.ts +2 -0
  150. package/dist/typescript/frame-by-index.d.ts.map +1 -0
  151. package/dist/typescript/frame-by-index.js +19 -0
  152. package/dist/typescript/frame-by-index.js.map +1 -0
  153. package/dist/typescript/get-attribute-value.d.ts +2 -0
  154. package/dist/typescript/get-attribute-value.d.ts.map +1 -0
  155. package/dist/typescript/get-attribute-value.js +22 -0
  156. package/dist/typescript/get-attribute-value.js.map +1 -0
  157. package/dist/typescript/get-effective-style.d.ts +3 -0
  158. package/dist/typescript/get-effective-style.d.ts.map +1 -0
  159. package/dist/typescript/get-effective-style.js +84 -0
  160. package/dist/typescript/get-effective-style.js.map +1 -0
  161. package/dist/typescript/get-element-from-cache.d.ts +2 -0
  162. package/dist/typescript/get-element-from-cache.d.ts.map +1 -0
  163. package/dist/typescript/get-element-from-cache.js +20 -0
  164. package/dist/typescript/get-element-from-cache.js.map +1 -0
  165. package/dist/typescript/get-frame-window.d.ts +2 -0
  166. package/dist/typescript/get-frame-window.d.ts.map +1 -0
  167. package/dist/typescript/get-frame-window.js +22 -0
  168. package/dist/typescript/get-frame-window.js.map +1 -0
  169. package/dist/typescript/get-local-storage-item.d.ts +3 -0
  170. package/dist/typescript/get-local-storage-item.d.ts.map +1 -0
  171. package/dist/typescript/get-local-storage-item.js +25 -0
  172. package/dist/typescript/get-local-storage-item.js.map +1 -0
  173. package/dist/typescript/get-local-storage-key.d.ts +3 -0
  174. package/dist/typescript/get-local-storage-key.d.ts.map +1 -0
  175. package/dist/typescript/get-local-storage-key.js +26 -0
  176. package/dist/typescript/get-local-storage-key.js.map +1 -0
  177. package/dist/typescript/get-local-storage-keys.d.ts +3 -0
  178. package/dist/typescript/get-local-storage-keys.d.ts.map +1 -0
  179. package/dist/typescript/get-local-storage-keys.js +25 -0
  180. package/dist/typescript/get-local-storage-keys.js.map +1 -0
  181. package/dist/typescript/get-local-storage-size.d.ts +3 -0
  182. package/dist/typescript/get-local-storage-size.d.ts.map +1 -0
  183. package/dist/typescript/get-local-storage-size.js +25 -0
  184. package/dist/typescript/get-local-storage-size.js.map +1 -0
  185. package/dist/typescript/get-location.d.ts +9 -0
  186. package/dist/typescript/get-location.d.ts.map +1 -0
  187. package/dist/typescript/get-location.js +49 -0
  188. package/dist/typescript/get-location.js.map +1 -0
  189. package/dist/typescript/get-session-storage-item.d.ts +3 -0
  190. package/dist/typescript/get-session-storage-item.d.ts.map +1 -0
  191. package/dist/typescript/get-session-storage-item.js +25 -0
  192. package/dist/typescript/get-session-storage-item.js.map +1 -0
  193. package/dist/typescript/get-session-storage-key.d.ts +3 -0
  194. package/dist/typescript/get-session-storage-key.d.ts.map +1 -0
  195. package/dist/typescript/get-session-storage-key.js +26 -0
  196. package/dist/typescript/get-session-storage-key.js.map +1 -0
  197. package/dist/typescript/get-session-storage-keys.d.ts +3 -0
  198. package/dist/typescript/get-session-storage-keys.d.ts.map +1 -0
  199. package/dist/typescript/get-session-storage-keys.js +25 -0
  200. package/dist/typescript/get-session-storage-keys.js.map +1 -0
  201. package/dist/typescript/get-session-storage-size.d.ts +3 -0
  202. package/dist/typescript/get-session-storage-size.d.ts.map +1 -0
  203. package/dist/typescript/get-session-storage-size.js +25 -0
  204. package/dist/typescript/get-session-storage-size.js.map +1 -0
  205. package/dist/typescript/get-size.d.ts +7 -0
  206. package/dist/typescript/get-size.d.ts.map +1 -0
  207. package/dist/typescript/get-size.js +36 -0
  208. package/dist/typescript/get-size.js.map +1 -0
  209. package/dist/typescript/get-text.d.ts +3 -0
  210. package/dist/typescript/get-text.d.ts.map +1 -0
  211. package/dist/typescript/get-text.js +294 -0
  212. package/dist/typescript/get-text.js.map +1 -0
  213. package/dist/typescript/get-top-left-coordinates.d.ts +4 -0
  214. package/dist/typescript/get-top-left-coordinates.d.ts.map +1 -0
  215. package/dist/typescript/get-top-left-coordinates.js +36 -0
  216. package/dist/typescript/get-top-left-coordinates.js.map +1 -0
  217. package/dist/typescript/is-displayed.d.ts +1 -2
  218. package/dist/typescript/is-displayed.d.ts.map +1 -1
  219. package/dist/typescript/is-displayed.js +3 -396
  220. package/dist/typescript/is-displayed.js.map +1 -1
  221. package/dist/typescript/is-editable.d.ts +2 -0
  222. package/dist/typescript/is-editable.d.ts.map +1 -0
  223. package/dist/typescript/is-editable.js +18 -0
  224. package/dist/typescript/is-editable.js.map +1 -0
  225. package/dist/typescript/is-enabled.d.ts +2 -0
  226. package/dist/typescript/is-enabled.d.ts.map +1 -0
  227. package/dist/typescript/is-enabled.js +18 -0
  228. package/dist/typescript/is-enabled.js.map +1 -0
  229. package/dist/typescript/is-focusable.d.ts +2 -0
  230. package/dist/typescript/is-focusable.d.ts.map +1 -0
  231. package/dist/typescript/is-focusable.js +20 -0
  232. package/dist/typescript/is-focusable.js.map +1 -0
  233. package/dist/typescript/is-interactable.d.ts +2 -0
  234. package/dist/typescript/is-interactable.d.ts.map +1 -0
  235. package/dist/typescript/is-interactable.js +19 -0
  236. package/dist/typescript/is-interactable.js.map +1 -0
  237. package/dist/typescript/is-selected.d.ts +3 -0
  238. package/dist/typescript/is-selected.d.ts.map +1 -0
  239. package/dist/typescript/is-selected.js +29 -0
  240. package/dist/typescript/is-selected.js.map +1 -0
  241. package/dist/typescript/remove-local-storage-item.d.ts +3 -0
  242. package/dist/typescript/remove-local-storage-item.d.ts.map +1 -0
  243. package/dist/typescript/remove-local-storage-item.js +25 -0
  244. package/dist/typescript/remove-local-storage-item.js.map +1 -0
  245. package/dist/typescript/remove-session-storage-item.d.ts +3 -0
  246. package/dist/typescript/remove-session-storage-item.d.ts.map +1 -0
  247. package/dist/typescript/remove-session-storage-item.js +25 -0
  248. package/dist/typescript/remove-session-storage-item.js.map +1 -0
  249. package/dist/typescript/set-local-storage-item.d.ts +3 -0
  250. package/dist/typescript/set-local-storage-item.d.ts.map +1 -0
  251. package/dist/typescript/set-local-storage-item.js +26 -0
  252. package/dist/typescript/set-local-storage-item.js.map +1 -0
  253. package/dist/typescript/set-session-storage-item.d.ts +3 -0
  254. package/dist/typescript/set-session-storage-item.d.ts.map +1 -0
  255. package/dist/typescript/set-session-storage-item.js +26 -0
  256. package/dist/typescript/set-session-storage-item.js.map +1 -0
  257. package/dist/typescript/submit.d.ts +3 -0
  258. package/dist/typescript/submit.d.ts.map +1 -0
  259. package/dist/typescript/submit.js +50 -0
  260. package/dist/typescript/submit.js.map +1 -0
  261. package/dist/typescript/type.d.ts +3 -0
  262. package/dist/typescript/type.d.ts.map +1 -0
  263. package/dist/typescript/type.js +201 -0
  264. package/dist/typescript/type.js.map +1 -0
  265. package/index.ts +40 -0
  266. package/package.json +292 -5
  267. package/typescript/active-element.ts +19 -0
  268. package/typescript/clear-local-storage.ts +27 -0
  269. package/typescript/clear-session-storage.ts +27 -0
  270. package/typescript/clear.ts +73 -0
  271. package/typescript/click.ts +55 -0
  272. package/typescript/core/attribute.ts +68 -0
  273. package/typescript/core/color.ts +257 -0
  274. package/typescript/core/editable.ts +63 -0
  275. package/typescript/core/element.ts +110 -0
  276. package/typescript/core/enabled.ts +76 -0
  277. package/typescript/core/error.ts +41 -0
  278. package/typescript/core/events.ts +268 -0
  279. package/typescript/core/focus.ts +92 -0
  280. package/typescript/core/focusable.ts +38 -0
  281. package/typescript/core/form.ts +81 -0
  282. package/typescript/core/frame.ts +105 -0
  283. package/typescript/core/geometry.ts +183 -0
  284. package/typescript/core/inject.ts +336 -0
  285. package/typescript/core/interactable.ts +30 -0
  286. package/typescript/core/keyboard.ts +369 -0
  287. package/typescript/core/keys.ts +204 -0
  288. package/typescript/core/locators.ts +704 -0
  289. package/typescript/core/mouse.ts +211 -0
  290. package/typescript/core/overflow.ts +172 -0
  291. package/typescript/core/scroll.ts +92 -0
  292. package/typescript/core/shown.ts +233 -0
  293. package/typescript/core/storage.ts +111 -0
  294. package/typescript/core/style.ts +32 -0
  295. package/typescript/core/useragent.ts +33 -0
  296. package/typescript/default-content.ts +20 -0
  297. package/typescript/execute-async-script.ts +20 -0
  298. package/typescript/execute-script.ts +20 -0
  299. package/typescript/find-element-fragment.ts +45 -0
  300. package/typescript/find-element.ts +18 -0
  301. package/typescript/find-elements.ts +1 -326
  302. package/typescript/frame-by-id-or-name.ts +22 -0
  303. package/typescript/frame-by-index.ts +19 -0
  304. package/typescript/get-attribute-value.ts +22 -0
  305. package/typescript/get-effective-style.ts +93 -0
  306. package/typescript/get-element-from-cache.ts +20 -0
  307. package/typescript/get-frame-window.ts +22 -0
  308. package/typescript/get-local-storage-item.ts +27 -0
  309. package/typescript/get-local-storage-key.ts +28 -0
  310. package/typescript/get-local-storage-keys.ts +27 -0
  311. package/typescript/get-local-storage-size.ts +27 -0
  312. package/typescript/get-location.ts +63 -0
  313. package/typescript/get-session-storage-item.ts +27 -0
  314. package/typescript/get-session-storage-key.ts +28 -0
  315. package/typescript/get-session-storage-keys.ts +27 -0
  316. package/typescript/get-session-storage-size.ts +27 -0
  317. package/typescript/get-size.ts +43 -0
  318. package/typescript/get-text.ts +353 -0
  319. package/typescript/get-top-left-coordinates.ts +38 -0
  320. package/typescript/is-displayed.ts +3 -498
  321. package/typescript/is-editable.ts +18 -0
  322. package/typescript/is-enabled.ts +18 -0
  323. package/typescript/is-focusable.ts +20 -0
  324. package/typescript/is-interactable.ts +19 -0
  325. package/typescript/is-selected.ts +31 -0
  326. package/typescript/remove-local-storage-item.ts +27 -0
  327. package/typescript/remove-session-storage-item.ts +27 -0
  328. package/typescript/set-local-storage-item.ts +28 -0
  329. package/typescript/set-session-storage-item.ts +28 -0
  330. package/typescript/submit.ts +53 -0
  331. package/typescript/type.ts +210 -0
package/package.json CHANGED
@@ -1,6 +1,5 @@
1
1
  {
2
2
  "name": "@selenium/atoms",
3
- "version": "4.51.0",
4
3
  "description": "Browser injection atoms for Selenium WebDriver",
5
4
  "type": "module",
6
5
  "main": "./dist/index.js",
@@ -19,16 +18,302 @@
19
18
  "types": "./dist/typescript/find-elements.d.ts",
20
19
  "default": "./dist/typescript/find-elements.js"
21
20
  },
21
+ "./find-element": {
22
+ "types": "./dist/typescript/find-element.d.ts",
23
+ "default": "./dist/typescript/find-element.js"
24
+ },
25
+ "./active-element": {
26
+ "types": "./dist/typescript/active-element.d.ts",
27
+ "default": "./dist/typescript/active-element.js"
28
+ },
29
+ "./default-content": {
30
+ "types": "./dist/typescript/default-content.d.ts",
31
+ "default": "./dist/typescript/default-content.js"
32
+ },
33
+ "./frame-by-id-or-name": {
34
+ "types": "./dist/typescript/frame-by-id-or-name.d.ts",
35
+ "default": "./dist/typescript/frame-by-id-or-name.js"
36
+ },
37
+ "./frame-by-index": {
38
+ "types": "./dist/typescript/frame-by-index.d.ts",
39
+ "default": "./dist/typescript/frame-by-index.js"
40
+ },
41
+ "./get-frame-window": {
42
+ "types": "./dist/typescript/get-frame-window.d.ts",
43
+ "default": "./dist/typescript/get-frame-window.js"
44
+ },
22
45
  "./is-displayed": {
23
46
  "types": "./dist/typescript/is-displayed.d.ts",
24
47
  "default": "./dist/typescript/is-displayed.js"
48
+ },
49
+ "./is-enabled": {
50
+ "types": "./dist/typescript/is-enabled.d.ts",
51
+ "default": "./dist/typescript/is-enabled.js"
52
+ },
53
+ "./is-selected": {
54
+ "types": "./dist/typescript/is-selected.d.ts",
55
+ "default": "./dist/typescript/is-selected.js"
56
+ },
57
+ "./is-editable": {
58
+ "types": "./dist/typescript/is-editable.d.ts",
59
+ "default": "./dist/typescript/is-editable.js"
60
+ },
61
+ "./is-focusable": {
62
+ "types": "./dist/typescript/is-focusable.d.ts",
63
+ "default": "./dist/typescript/is-focusable.js"
64
+ },
65
+ "./is-interactable": {
66
+ "types": "./dist/typescript/is-interactable.d.ts",
67
+ "default": "./dist/typescript/is-interactable.js"
68
+ },
69
+ "./get-attribute-value": {
70
+ "types": "./dist/typescript/get-attribute-value.d.ts",
71
+ "default": "./dist/typescript/get-attribute-value.js"
72
+ },
73
+ "./get-size": {
74
+ "types": "./dist/typescript/get-size.d.ts",
75
+ "default": "./dist/typescript/get-size.js"
76
+ },
77
+ "./get-location": {
78
+ "types": "./dist/typescript/get-location.d.ts",
79
+ "default": "./dist/typescript/get-location.js"
80
+ },
81
+ "./get-effective-style": {
82
+ "types": "./dist/typescript/get-effective-style.d.ts",
83
+ "default": "./dist/typescript/get-effective-style.js"
84
+ },
85
+ "./get-value-of-css-property": {
86
+ "types": "./dist/typescript/get-effective-style.d.ts",
87
+ "default": "./dist/typescript/get-effective-style.js"
88
+ },
89
+ "./get-top-left-coordinates": {
90
+ "types": "./dist/typescript/get-top-left-coordinates.d.ts",
91
+ "default": "./dist/typescript/get-top-left-coordinates.js"
92
+ },
93
+ "./get-text": {
94
+ "types": "./dist/typescript/get-text.d.ts",
95
+ "default": "./dist/typescript/get-text.js"
96
+ },
97
+ "./get-local-storage-item": {
98
+ "types": "./dist/typescript/get-local-storage-item.d.ts",
99
+ "default": "./dist/typescript/get-local-storage-item.js"
100
+ },
101
+ "./get-local-storage-key": {
102
+ "types": "./dist/typescript/get-local-storage-key.d.ts",
103
+ "default": "./dist/typescript/get-local-storage-key.js"
104
+ },
105
+ "./get-local-storage-keys": {
106
+ "types": "./dist/typescript/get-local-storage-keys.d.ts",
107
+ "default": "./dist/typescript/get-local-storage-keys.js"
108
+ },
109
+ "./get-local-storage-size": {
110
+ "types": "./dist/typescript/get-local-storage-size.d.ts",
111
+ "default": "./dist/typescript/get-local-storage-size.js"
112
+ },
113
+ "./set-local-storage-item": {
114
+ "types": "./dist/typescript/set-local-storage-item.d.ts",
115
+ "default": "./dist/typescript/set-local-storage-item.js"
116
+ },
117
+ "./remove-local-storage-item": {
118
+ "types": "./dist/typescript/remove-local-storage-item.d.ts",
119
+ "default": "./dist/typescript/remove-local-storage-item.js"
120
+ },
121
+ "./clear-local-storage": {
122
+ "types": "./dist/typescript/clear-local-storage.d.ts",
123
+ "default": "./dist/typescript/clear-local-storage.js"
124
+ },
125
+ "./get-session-storage-item": {
126
+ "types": "./dist/typescript/get-session-storage-item.d.ts",
127
+ "default": "./dist/typescript/get-session-storage-item.js"
128
+ },
129
+ "./get-session-storage-key": {
130
+ "types": "./dist/typescript/get-session-storage-key.d.ts",
131
+ "default": "./dist/typescript/get-session-storage-key.js"
132
+ },
133
+ "./get-session-storage-keys": {
134
+ "types": "./dist/typescript/get-session-storage-keys.d.ts",
135
+ "default": "./dist/typescript/get-session-storage-keys.js"
136
+ },
137
+ "./get-session-storage-size": {
138
+ "types": "./dist/typescript/get-session-storage-size.d.ts",
139
+ "default": "./dist/typescript/get-session-storage-size.js"
140
+ },
141
+ "./set-session-storage-item": {
142
+ "types": "./dist/typescript/set-session-storage-item.d.ts",
143
+ "default": "./dist/typescript/set-session-storage-item.js"
144
+ },
145
+ "./remove-session-storage-item": {
146
+ "types": "./dist/typescript/remove-session-storage-item.d.ts",
147
+ "default": "./dist/typescript/remove-session-storage-item.js"
148
+ },
149
+ "./clear-session-storage": {
150
+ "types": "./dist/typescript/clear-session-storage.d.ts",
151
+ "default": "./dist/typescript/clear-session-storage.js"
152
+ },
153
+ "./execute-script": {
154
+ "types": "./dist/typescript/execute-script.d.ts",
155
+ "default": "./dist/typescript/execute-script.js"
156
+ },
157
+ "./execute-async-script": {
158
+ "types": "./dist/typescript/execute-async-script.d.ts",
159
+ "default": "./dist/typescript/execute-async-script.js"
160
+ },
161
+ "./get-element-from-cache": {
162
+ "types": "./dist/typescript/get-element-from-cache.d.ts",
163
+ "default": "./dist/typescript/get-element-from-cache.js"
164
+ },
165
+ "./find-element-fragment": {
166
+ "types": "./dist/typescript/find-element-fragment.d.ts",
167
+ "default": "./dist/typescript/find-element-fragment.js"
168
+ },
169
+ "./click": {
170
+ "types": "./dist/typescript/click.d.ts",
171
+ "default": "./dist/typescript/click.js"
172
+ },
173
+ "./type": {
174
+ "types": "./dist/typescript/type.d.ts",
175
+ "default": "./dist/typescript/type.js"
176
+ },
177
+ "./clear": {
178
+ "types": "./dist/typescript/clear.d.ts",
179
+ "default": "./dist/typescript/clear.js"
180
+ },
181
+ "./submit": {
182
+ "types": "./dist/typescript/submit.d.ts",
183
+ "default": "./dist/typescript/submit.js"
25
184
  }
26
185
  },
27
186
  "typesVersions": {
28
187
  "*": {
29
- "get-attribute": ["./dist/typescript/get-attribute.d.ts"],
30
- "find-elements": ["./dist/typescript/find-elements.d.ts"],
31
- "is-displayed": ["./dist/typescript/is-displayed.d.ts"]
188
+ "get-attribute": [
189
+ "./dist/typescript/get-attribute.d.ts"
190
+ ],
191
+ "find-elements": [
192
+ "./dist/typescript/find-elements.d.ts"
193
+ ],
194
+ "find-element": [
195
+ "./dist/typescript/find-element.d.ts"
196
+ ],
197
+ "active-element": [
198
+ "./dist/typescript/active-element.d.ts"
199
+ ],
200
+ "default-content": [
201
+ "./dist/typescript/default-content.d.ts"
202
+ ],
203
+ "frame-by-id-or-name": [
204
+ "./dist/typescript/frame-by-id-or-name.d.ts"
205
+ ],
206
+ "frame-by-index": [
207
+ "./dist/typescript/frame-by-index.d.ts"
208
+ ],
209
+ "get-frame-window": [
210
+ "./dist/typescript/get-frame-window.d.ts"
211
+ ],
212
+ "is-displayed": [
213
+ "./dist/typescript/is-displayed.d.ts"
214
+ ],
215
+ "is-enabled": [
216
+ "./dist/typescript/is-enabled.d.ts"
217
+ ],
218
+ "is-selected": [
219
+ "./dist/typescript/is-selected.d.ts"
220
+ ],
221
+ "is-editable": [
222
+ "./dist/typescript/is-editable.d.ts"
223
+ ],
224
+ "is-focusable": [
225
+ "./dist/typescript/is-focusable.d.ts"
226
+ ],
227
+ "is-interactable": [
228
+ "./dist/typescript/is-interactable.d.ts"
229
+ ],
230
+ "get-attribute-value": [
231
+ "./dist/typescript/get-attribute-value.d.ts"
232
+ ],
233
+ "get-size": [
234
+ "./dist/typescript/get-size.d.ts"
235
+ ],
236
+ "get-location": [
237
+ "./dist/typescript/get-location.d.ts"
238
+ ],
239
+ "get-effective-style": [
240
+ "./dist/typescript/get-effective-style.d.ts"
241
+ ],
242
+ "get-value-of-css-property": [
243
+ "./dist/typescript/get-effective-style.d.ts"
244
+ ],
245
+ "get-top-left-coordinates": [
246
+ "./dist/typescript/get-top-left-coordinates.d.ts"
247
+ ],
248
+ "get-text": [
249
+ "./dist/typescript/get-text.d.ts"
250
+ ],
251
+ "get-local-storage-item": [
252
+ "./dist/typescript/get-local-storage-item.d.ts"
253
+ ],
254
+ "get-local-storage-key": [
255
+ "./dist/typescript/get-local-storage-key.d.ts"
256
+ ],
257
+ "get-local-storage-keys": [
258
+ "./dist/typescript/get-local-storage-keys.d.ts"
259
+ ],
260
+ "get-local-storage-size": [
261
+ "./dist/typescript/get-local-storage-size.d.ts"
262
+ ],
263
+ "set-local-storage-item": [
264
+ "./dist/typescript/set-local-storage-item.d.ts"
265
+ ],
266
+ "remove-local-storage-item": [
267
+ "./dist/typescript/remove-local-storage-item.d.ts"
268
+ ],
269
+ "clear-local-storage": [
270
+ "./dist/typescript/clear-local-storage.d.ts"
271
+ ],
272
+ "get-session-storage-item": [
273
+ "./dist/typescript/get-session-storage-item.d.ts"
274
+ ],
275
+ "get-session-storage-key": [
276
+ "./dist/typescript/get-session-storage-key.d.ts"
277
+ ],
278
+ "get-session-storage-keys": [
279
+ "./dist/typescript/get-session-storage-keys.d.ts"
280
+ ],
281
+ "get-session-storage-size": [
282
+ "./dist/typescript/get-session-storage-size.d.ts"
283
+ ],
284
+ "set-session-storage-item": [
285
+ "./dist/typescript/set-session-storage-item.d.ts"
286
+ ],
287
+ "remove-session-storage-item": [
288
+ "./dist/typescript/remove-session-storage-item.d.ts"
289
+ ],
290
+ "clear-session-storage": [
291
+ "./dist/typescript/clear-session-storage.d.ts"
292
+ ],
293
+ "execute-script": [
294
+ "./dist/typescript/execute-script.d.ts"
295
+ ],
296
+ "execute-async-script": [
297
+ "./dist/typescript/execute-async-script.d.ts"
298
+ ],
299
+ "get-element-from-cache": [
300
+ "./dist/typescript/get-element-from-cache.d.ts"
301
+ ],
302
+ "find-element-fragment": [
303
+ "./dist/typescript/find-element-fragment.d.ts"
304
+ ],
305
+ "click": [
306
+ "./dist/typescript/click.d.ts"
307
+ ],
308
+ "type": [
309
+ "./dist/typescript/type.d.ts"
310
+ ],
311
+ "clear": [
312
+ "./dist/typescript/clear.d.ts"
313
+ ],
314
+ "submit": [
315
+ "./dist/typescript/submit.d.ts"
316
+ ]
32
317
  }
33
318
  },
34
319
  "engines": {
@@ -38,6 +323,7 @@
38
323
  "dist/",
39
324
  "index.ts",
40
325
  "typescript/",
326
+ "!typescript/testing/",
41
327
  "LICENSE",
42
328
  "NOTICE",
43
329
  "README.md"
@@ -51,5 +337,6 @@
51
337
  "access": "public",
52
338
  "registry": "https://registry.npmjs.org/"
53
339
  },
54
- "license": "Apache-2.0"
340
+ "license": "Apache-2.0",
341
+ "version": "4.52.0"
55
342
  }
@@ -0,0 +1,19 @@
1
+ // Licensed to the Software Freedom Conservancy (SFC) under one
2
+ // or more contributor license agreements. See the NOTICE file
3
+ // distributed with this work for additional information
4
+ // regarding copyright ownership. The SFC licenses this file
5
+ // to you under the Apache License, Version 2.0 (the
6
+ // "License"); you may not use this file except in compliance
7
+ // with the License. You may obtain a copy of the License at
8
+ //
9
+ // http://www.apache.org/licenses/LICENSE-2.0
10
+ //
11
+ // Unless required by applicable law or agreed to in writing,
12
+ // software distributed under the License is distributed on an
13
+ // "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
14
+ // KIND, either express or implied. See the License for the
15
+ // specific language governing permissions and limitations
16
+ // under the License.
17
+
18
+ // The focused element, or the body when nothing is focused.
19
+ export { activeElement as default } from './core/frame.js'
@@ -0,0 +1,27 @@
1
+ // Licensed to the Software Freedom Conservancy (SFC) under one
2
+ // or more contributor license agreements. See the NOTICE file
3
+ // distributed with this work for additional information
4
+ // regarding copyright ownership. The SFC licenses this file
5
+ // to you under the Apache License, Version 2.0 (the
6
+ // "License"); you may not use this file except in compliance
7
+ // with the License. You may obtain a copy of the License at
8
+ //
9
+ // http://www.apache.org/licenses/LICENSE-2.0
10
+ //
11
+ // Unless required by applicable law or agreed to in writing,
12
+ // software distributed under the License is distributed on an
13
+ // "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
14
+ // KIND, either express or implied. See the License for the
15
+ // specific language governing permissions and limitations
16
+ // under the License.
17
+
18
+ import { getLocalStorage } from './core/storage.js'
19
+
20
+ // Empties the store.
21
+ //
22
+ // optWindow targets a frame other than the one the atom is running in.
23
+ function clearLocalStorage(optWindow?: Window): void {
24
+ getLocalStorage(optWindow).clear()
25
+ }
26
+
27
+ export default clearLocalStorage
@@ -0,0 +1,27 @@
1
+ // Licensed to the Software Freedom Conservancy (SFC) under one
2
+ // or more contributor license agreements. See the NOTICE file
3
+ // distributed with this work for additional information
4
+ // regarding copyright ownership. The SFC licenses this file
5
+ // to you under the Apache License, Version 2.0 (the
6
+ // "License"); you may not use this file except in compliance
7
+ // with the License. You may obtain a copy of the License at
8
+ //
9
+ // http://www.apache.org/licenses/LICENSE-2.0
10
+ //
11
+ // Unless required by applicable law or agreed to in writing,
12
+ // software distributed under the License is distributed on an
13
+ // "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
14
+ // KIND, either express or implied. See the License for the
15
+ // specific language governing permissions and limitations
16
+ // under the License.
17
+
18
+ import { getSessionStorage } from './core/storage.js'
19
+
20
+ // Empties the store.
21
+ //
22
+ // optWindow targets a frame other than the one the atom is running in.
23
+ function clearSessionStorage(optWindow?: Window): void {
24
+ getSessionStorage(optWindow).clear()
25
+ }
26
+
27
+ export default clearSessionStorage
@@ -0,0 +1,73 @@
1
+ // Licensed to the Software Freedom Conservancy (SFC) under one
2
+ // or more contributor license agreements. See the NOTICE file
3
+ // distributed with this work for additional information
4
+ // regarding copyright ownership. The SFC licenses this file
5
+ // to you under the Apache License, Version 2.0 (the
6
+ // "License"); you may not use this file except in compliance
7
+ // with the License. You may obtain a copy of the License at
8
+ //
9
+ // http://www.apache.org/licenses/LICENSE-2.0
10
+ //
11
+ // Unless required by applicable law or agreed to in writing,
12
+ // software distributed under the License is distributed on an
13
+ // "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
14
+ // KIND, either express or implied. See the License for the
15
+ // specific language governing permissions and limitations
16
+ // under the License.
17
+
18
+ import { isContentEditable, isEditable } from './core/editable.js'
19
+ import { ELEMENT_NOT_INTERACTABLE, INVALID_ELEMENT_STATE, botError } from './core/error.js'
20
+ import { EventType, fire } from './core/events.js'
21
+ import { focusOnElement } from './core/focus.js'
22
+ import { isInteractable } from './core/interactable.js'
23
+
24
+ type TextField = HTMLInputElement | HTMLTextAreaElement
25
+
26
+ // Empties an editable element the way W3C Element Clear does: focus it, empty
27
+ // it, then take focus away so the page sees the edit committed.
28
+ //
29
+ // Differences from bot.action.clear, toward what clearing by hand produces:
30
+ // - input fires before change; bot.action.clear fired change alone. Its
31
+ // inputType is what select-all then Backspace reports: neither engine keeps
32
+ // the spec's generic "deleteContent" on a constructed InputEvent.
33
+ // - A number field holding unparseable text (value reads as "") is detected
34
+ // by validity.badInput rather than the type attribute, and gets the same
35
+ // events and blur as any other field.
36
+ // - contenteditable is emptied outright and fires input. The single space
37
+ // bot.action.clear left behind in Firefox kept the caret alive in Firefox 3.
38
+ // - The IE range-input and blur branches are gone.
39
+ function clear(element: Element): void {
40
+ if (!isInteractable(element)) {
41
+ throw botError(ELEMENT_NOT_INTERACTABLE, 'Element is not currently interactable and may not be manipulated')
42
+ }
43
+ if (!isEditable(element)) {
44
+ throw botError(INVALID_ELEMENT_STATE, 'Element must be user-editable in order to clear it.')
45
+ }
46
+
47
+ if (isContentEditable(element)) {
48
+ if (element.textContent || element.children.length) {
49
+ focusOnElement(element)
50
+ element.textContent = ''
51
+ fire(element, EventType.INPUT, { inputType: 'deleteContentBackward', data: null })
52
+ unfocus(element)
53
+ }
54
+ return
55
+ }
56
+
57
+ const field = element as TextField
58
+ const badInput = !!(field as HTMLInputElement).validity?.badInput
59
+ if (field.value || badInput) {
60
+ focusOnElement(field)
61
+ field.value = ''
62
+ fire(field, EventType.INPUT, { inputType: 'deleteContentBackward', data: null })
63
+ fire(field, EventType.CHANGE, undefined)
64
+ unfocus(field)
65
+ }
66
+ }
67
+
68
+ // Focusing the body cannot take focus, so this blurs whatever has it.
69
+ function unfocus(element: Element): void {
70
+ focusOnElement(element.ownerDocument.body)
71
+ }
72
+
73
+ export default clear
@@ -0,0 +1,55 @@
1
+ // Licensed to the Software Freedom Conservancy (SFC) under one
2
+ // or more contributor license agreements. See the NOTICE file
3
+ // distributed with this work for additional information
4
+ // regarding copyright ownership. The SFC licenses this file
5
+ // to you under the Apache License, Version 2.0 (the
6
+ // "License"); you may not use this file except in compliance
7
+ // with the License. You may obtain a copy of the License at
8
+ //
9
+ // http://www.apache.org/licenses/LICENSE-2.0
10
+ //
11
+ // Unless required by applicable law or agreed to in writing,
12
+ // software distributed under the License is distributed on an
13
+ // "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
14
+ // KIND, either express or implied. See the License for the
15
+ // specific language governing permissions and limitations
16
+ // under the License.
17
+
18
+ import { ELEMENT_NOT_INTERACTABLE, botError } from './core/error.js'
19
+ import { type Coordinate, getClientRect } from './core/geometry.js'
20
+ import { Mouse } from './core/mouse.js'
21
+ import { scrollIntoView } from './core/scroll.js'
22
+ import isShown from './core/shown.js'
23
+
24
+ // Clicks the element with the primary button: scrolls it into view, moves a
25
+ // fresh mouse to `optCoords` (relative to the element's top-left) or its
26
+ // centre, presses and releases. See core/mouse.ts for the events produced.
27
+ //
28
+ // bot.action.click also took a mouse to reuse and a flag forcing mouseup onto
29
+ // a non-interactable element. Neither crosses the wire, so they are not kept.
30
+ function click(element: Element, optCoords?: Coordinate | null): void {
31
+ if (!isShown(element, /* optIgnoreOpacity= */ true)) {
32
+ throw botError(ELEMENT_NOT_INTERACTABLE, 'Element is not currently visible and may not be manipulated')
33
+ }
34
+ scrollIntoView(element, optCoords || undefined)
35
+ const mouse = new Mouse()
36
+ mouse.move(element, optCoords || interactableCentre(element))
37
+ mouse.pressButton()
38
+ mouse.releaseButton()
39
+ }
40
+
41
+ // An element with no area of its own (an empty inline wrapper, say) is aimed
42
+ // at through its offsetParent's size, as bot.action.getInteractableSize did.
43
+ function interactableCentre(element: Element): Coordinate {
44
+ let node: Element = element
45
+ for (;;) {
46
+ const rect = getClientRect(node)
47
+ const parent = (node as HTMLElement).offsetParent
48
+ if ((rect.width > 0 && rect.height > 0) || !parent) {
49
+ return { x: rect.width / 2, y: rect.height / 2 }
50
+ }
51
+ node = parent
52
+ }
53
+ }
54
+
55
+ export default click
@@ -0,0 +1,68 @@
1
+ // Licensed to the Software Freedom Conservancy (SFC) under one
2
+ // or more contributor license agreements. See the NOTICE file
3
+ // distributed with this work for additional information
4
+ // regarding copyright ownership. The SFC licenses this file
5
+ // to you under the Apache License, Version 2.0 (the
6
+ // "License"); you may not use this file except in compliance
7
+ // with the License. You may obtain a copy of the License at
8
+ //
9
+ // http://www.apache.org/licenses/LICENSE-2.0
10
+ //
11
+ // Unless required by applicable law or agreed to in writing,
12
+ // software distributed under the License is distributed on an
13
+ // "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
14
+ // KIND, either express or implied. See the License for the
15
+ // specific language governing permissions and limitations
16
+ // under the License.
17
+
18
+ // Raw attribute and property access, ported from bot.dom.core (domcore.js).
19
+ //
20
+ // This is *not* the WebDriver getAttribute algorithm — that one consults
21
+ // properties, boolean-attribute tables and aliases, and lives in
22
+ // get-attribute.ts. This returns what the author actually wrote in the markup.
23
+ //
24
+ // The IE-only branches in the Closure original (IE_DOC_PRE8's <input value>,
25
+ // IE_DOC_PRE9's boolean attributes, the <option value> text fallback) are
26
+ // dropped, matching every other TypeScript atom in this directory.
27
+
28
+ // Splits on semicolons that are not inside quotes or parens, so a value like
29
+ // `background: url(a;b)` or `content: ";"` survives intact. If the attribute
30
+ // ends in a semicolon the split yields a trailing empty entry, which the
31
+ // caller skips.
32
+ const SPLIT_STYLE_ATTRIBUTE_ON_SEMICOLONS = new RegExp(
33
+ '[;]+' +
34
+ '(?=(?:(?:[^"]*"){2})*[^"]*$)' +
35
+ "(?=(?:(?:[^']*'){2})*[^']*$)" +
36
+ '(?=(?:[^()]*\\([^()]*\\))*[^()]*$)',
37
+ )
38
+
39
+ // Lower-cases property names and guarantees a trailing semicolon, so the same
40
+ // style attribute reads identically no matter how the browser serialised it.
41
+ function standardizeStyleAttribute(value: string): string {
42
+ const declarations: string[] = []
43
+ for (const pair of value.split(SPLIT_STYLE_ATTRIBUTE_ON_SEMICOLONS)) {
44
+ const separator = pair.indexOf(':')
45
+ if (separator > 0) {
46
+ declarations.push(pair.slice(0, separator).toLowerCase(), ':', pair.slice(separator + 1), ';')
47
+ }
48
+ }
49
+ const css = declarations.join('')
50
+ return css.charAt(css.length - 1) === ';' ? css : css + ';'
51
+ }
52
+
53
+ export function getAttribute(element: Element, attributeName: string): string | null {
54
+ const name = attributeName.toLowerCase()
55
+
56
+ if (name === 'style') {
57
+ return standardizeStyleAttribute((element as HTMLElement).style.cssText)
58
+ }
59
+
60
+ // `specified` distinguishes an attribute the author wrote from one the
61
+ // browser defaulted in.
62
+ const attr = element.getAttributeNode(name)
63
+ return attr && attr.specified ? attr.value : null
64
+ }
65
+
66
+ export function getProperty(element: Element, propertyName: string): unknown {
67
+ return (element as unknown as Record<string, unknown>)[propertyName]
68
+ }