@testing-library/user-event 14.3.0 → 14.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 (237) hide show
  1. package/dist/cjs/clipboard/copy.js +40 -0
  2. package/dist/cjs/clipboard/cut.js +40 -0
  3. package/dist/cjs/clipboard/index.js +13 -0
  4. package/dist/cjs/clipboard/paste.js +41 -0
  5. package/dist/cjs/convenience/click.js +40 -0
  6. package/dist/cjs/convenience/hover.js +37 -0
  7. package/dist/cjs/convenience/index.js +16 -0
  8. package/dist/cjs/convenience/tab.js +9 -0
  9. package/dist/cjs/document/index.js +74 -0
  10. package/dist/cjs/document/interceptor.js +30 -0
  11. package/dist/cjs/document/selection.js +107 -0
  12. package/dist/cjs/document/setRangeText.js +21 -0
  13. package/dist/cjs/document/value.js +125 -0
  14. package/dist/cjs/event/behavior/click.js +42 -0
  15. package/dist/cjs/event/behavior/cut.js +26 -0
  16. package/dist/cjs/event/behavior/index.js +15 -0
  17. package/dist/cjs/event/behavior/keydown.js +134 -0
  18. package/dist/cjs/event/behavior/keypress.js +58 -0
  19. package/dist/cjs/event/behavior/keyup.js +24 -0
  20. package/dist/cjs/event/behavior/paste.js +29 -0
  21. package/dist/cjs/event/behavior/registry.js +7 -0
  22. package/dist/cjs/event/createEvent.js +193 -0
  23. package/dist/cjs/event/dispatchEvent.js +37 -0
  24. package/dist/cjs/event/dom-events.d.js +2 -0
  25. package/dist/cjs/event/eventMap.js +64 -0
  26. package/dist/cjs/event/index.js +24 -0
  27. package/dist/cjs/event/types.js +2 -0
  28. package/dist/cjs/event/wrapEvent.js +11 -0
  29. package/dist/cjs/index.js +14 -0
  30. package/dist/cjs/keyboard/index.js +59 -0
  31. package/dist/cjs/keyboard/keyMap.js +158 -0
  32. package/dist/cjs/keyboard/parseKeyDef.js +58 -0
  33. package/dist/cjs/options.js +42 -0
  34. package/dist/cjs/package.json +3 -0
  35. package/dist/cjs/pointer/index.js +88 -0
  36. package/dist/cjs/pointer/keyMap.js +35 -0
  37. package/dist/cjs/pointer/parseKeyDef.js +39 -0
  38. package/dist/cjs/setup/api.js +35 -0
  39. package/dist/cjs/setup/config.js +7 -0
  40. package/dist/cjs/setup/directApi.js +77 -0
  41. package/dist/cjs/setup/index.js +15 -0
  42. package/dist/cjs/setup/setup.js +97 -0
  43. package/dist/cjs/setup/wrapAsync.js +13 -0
  44. package/dist/cjs/system/index.js +31 -0
  45. package/dist/cjs/system/keyboard.js +135 -0
  46. package/dist/cjs/system/pointer/buttons.js +71 -0
  47. package/dist/cjs/system/pointer/device.js +21 -0
  48. package/dist/cjs/system/pointer/index.js +146 -0
  49. package/dist/cjs/system/pointer/mouse.js +186 -0
  50. package/dist/cjs/system/pointer/pointer.js +114 -0
  51. package/dist/cjs/utility/clear.js +42 -0
  52. package/dist/cjs/utility/index.js +16 -0
  53. package/dist/cjs/utility/selectOptions.js +125 -0
  54. package/dist/cjs/utility/type.js +41 -0
  55. package/dist/cjs/utility/upload.js +72 -0
  56. package/dist/cjs/utils/click/isClickableInput.js +22 -0
  57. package/dist/cjs/utils/dataTransfer/Blob.js +18 -0
  58. package/dist/cjs/utils/dataTransfer/Clipboard.js +168 -0
  59. package/dist/cjs/utils/dataTransfer/DataTransfer.js +124 -0
  60. package/dist/cjs/utils/dataTransfer/FileList.js +26 -0
  61. package/dist/cjs/utils/edit/buildTimeValue.js +36 -0
  62. package/dist/cjs/utils/edit/getValue.js +35 -0
  63. package/dist/cjs/utils/edit/input.js +162 -0
  64. package/dist/cjs/utils/edit/isContentEditable.js +20 -0
  65. package/dist/cjs/utils/edit/isEditable.js +35 -0
  66. package/dist/cjs/utils/edit/isValidDateOrTimeValue.js +11 -0
  67. package/dist/cjs/utils/edit/maxLength.js +38 -0
  68. package/dist/cjs/utils/edit/setFiles.js +59 -0
  69. package/dist/cjs/utils/edit/walkRadio.js +28 -0
  70. package/dist/cjs/utils/focus/blur.js +16 -0
  71. package/dist/cjs/utils/focus/copySelection.js +46 -0
  72. package/dist/cjs/utils/focus/cursor.js +143 -0
  73. package/dist/cjs/utils/focus/focus.js +26 -0
  74. package/dist/cjs/utils/focus/getActiveElement.js +24 -0
  75. package/dist/cjs/utils/focus/getTabDestination.js +82 -0
  76. package/dist/cjs/utils/focus/isFocusable.js +11 -0
  77. package/dist/cjs/utils/focus/resolveCaretPosition.js +78 -0
  78. package/dist/cjs/utils/focus/selectAll.js +54 -0
  79. package/dist/cjs/utils/focus/selection.js +287 -0
  80. package/dist/cjs/utils/focus/selector.js +16 -0
  81. package/dist/cjs/utils/index.js +108 -0
  82. package/dist/cjs/utils/keyDef/readNextDescriptor.js +92 -0
  83. package/dist/cjs/utils/misc/cloneEvent.js +9 -0
  84. package/dist/cjs/utils/misc/dom-helpers.d.js +2 -0
  85. package/dist/cjs/utils/misc/eventWrapper.js +15 -0
  86. package/dist/cjs/utils/misc/findClosest.js +16 -0
  87. package/dist/cjs/utils/misc/getDocumentFromNode.js +12 -0
  88. package/dist/cjs/utils/misc/getTreeDiff.js +27 -0
  89. package/dist/cjs/utils/misc/getWindow.js +11 -0
  90. package/dist/cjs/utils/misc/isDescendantOrSelf.js +16 -0
  91. package/dist/cjs/utils/misc/isDisabled.js +34 -0
  92. package/dist/cjs/utils/misc/isElementType.js +22 -0
  93. package/dist/cjs/utils/misc/isVisible.js +21 -0
  94. package/dist/cjs/utils/misc/level.js +20 -0
  95. package/dist/cjs/utils/misc/wait.js +16 -0
  96. package/dist/cjs/utils/pointer/cssPointerEvents.js +111 -0
  97. package/dist/esm/clipboard/copy.js +36 -0
  98. package/dist/esm/clipboard/cut.js +36 -0
  99. package/dist/esm/clipboard/index.js +3 -0
  100. package/dist/esm/clipboard/paste.js +37 -0
  101. package/dist/esm/convenience/click.js +34 -0
  102. package/dist/esm/convenience/hover.js +32 -0
  103. package/dist/esm/convenience/index.js +3 -0
  104. package/dist/esm/convenience/tab.js +5 -0
  105. package/dist/esm/document/index.js +66 -0
  106. package/dist/esm/document/interceptor.js +26 -0
  107. package/dist/esm/document/selection.js +99 -0
  108. package/dist/esm/document/setRangeText.js +17 -0
  109. package/dist/esm/document/value.js +115 -0
  110. package/dist/esm/event/behavior/click.js +40 -0
  111. package/dist/esm/event/behavior/cut.js +24 -0
  112. package/dist/esm/event/behavior/index.js +7 -0
  113. package/dist/esm/event/behavior/keydown.js +132 -0
  114. package/dist/esm/event/behavior/keypress.js +56 -0
  115. package/dist/esm/event/behavior/keyup.js +22 -0
  116. package/dist/esm/event/behavior/paste.js +27 -0
  117. package/dist/esm/event/behavior/registry.js +3 -0
  118. package/dist/esm/event/createEvent.js +189 -0
  119. package/dist/esm/event/dispatchEvent.js +33 -0
  120. package/dist/esm/event/dom-events.d.js +1 -0
  121. package/dist/esm/event/eventMap.js +57 -0
  122. package/dist/esm/event/index.js +19 -0
  123. package/dist/esm/event/types.js +1 -0
  124. package/dist/esm/event/wrapEvent.js +7 -0
  125. package/dist/esm/index.js +2 -0
  126. package/dist/esm/keyboard/index.js +54 -0
  127. package/dist/esm/keyboard/keyMap.js +154 -0
  128. package/dist/esm/keyboard/parseKeyDef.js +54 -0
  129. package/dist/esm/options.js +37 -0
  130. package/dist/esm/package.json +3 -0
  131. package/dist/esm/pointer/index.js +84 -0
  132. package/dist/esm/pointer/keyMap.js +31 -0
  133. package/dist/esm/pointer/parseKeyDef.js +35 -0
  134. package/dist/esm/setup/api.js +12 -0
  135. package/dist/esm/setup/config.js +3 -0
  136. package/dist/esm/setup/directApi.js +58 -0
  137. package/dist/esm/setup/index.js +10 -0
  138. package/dist/esm/setup/setup.js +90 -0
  139. package/dist/esm/setup/wrapAsync.js +9 -0
  140. package/dist/esm/system/index.js +27 -0
  141. package/dist/esm/system/keyboard.js +131 -0
  142. package/dist/esm/system/pointer/buttons.js +63 -0
  143. package/dist/esm/system/pointer/device.js +17 -0
  144. package/dist/esm/system/pointer/index.js +141 -0
  145. package/dist/esm/system/pointer/mouse.js +182 -0
  146. package/dist/esm/system/pointer/pointer.js +110 -0
  147. package/dist/esm/utility/clear.js +38 -0
  148. package/dist/esm/utility/index.js +4 -0
  149. package/dist/esm/utility/selectOptions.js +120 -0
  150. package/dist/esm/utility/type.js +37 -0
  151. package/dist/esm/utility/upload.js +68 -0
  152. package/dist/esm/utils/click/isClickableInput.js +18 -0
  153. package/dist/esm/utils/dataTransfer/Blob.js +14 -0
  154. package/dist/esm/utils/dataTransfer/Clipboard.js +159 -0
  155. package/dist/esm/utils/dataTransfer/DataTransfer.js +119 -0
  156. package/dist/esm/utils/dataTransfer/FileList.js +22 -0
  157. package/dist/esm/utils/edit/buildTimeValue.js +32 -0
  158. package/dist/esm/utils/edit/getValue.js +31 -0
  159. package/dist/esm/utils/edit/input.js +158 -0
  160. package/dist/esm/utils/edit/isContentEditable.js +15 -0
  161. package/dist/esm/utils/edit/isEditable.js +30 -0
  162. package/dist/esm/utils/edit/isValidDateOrTimeValue.js +7 -0
  163. package/dist/esm/utils/edit/maxLength.js +34 -0
  164. package/dist/esm/utils/edit/setFiles.js +55 -0
  165. package/dist/esm/utils/edit/walkRadio.js +24 -0
  166. package/dist/esm/utils/focus/blur.js +12 -0
  167. package/dist/esm/utils/focus/copySelection.js +42 -0
  168. package/dist/esm/utils/focus/cursor.js +139 -0
  169. package/dist/esm/utils/focus/focus.js +22 -0
  170. package/dist/esm/utils/focus/getActiveElement.js +19 -0
  171. package/dist/esm/utils/focus/getTabDestination.js +78 -0
  172. package/dist/esm/utils/focus/isFocusable.js +7 -0
  173. package/dist/esm/utils/focus/resolveCaretPosition.js +74 -0
  174. package/dist/esm/utils/focus/selectAll.js +49 -0
  175. package/dist/esm/utils/focus/selection.js +274 -0
  176. package/dist/esm/utils/focus/selector.js +12 -0
  177. package/dist/esm/utils/index.js +36 -0
  178. package/dist/esm/utils/keyDef/readNextDescriptor.js +88 -0
  179. package/dist/esm/utils/misc/cloneEvent.js +5 -0
  180. package/dist/esm/utils/misc/dom-helpers.d.js +1 -0
  181. package/dist/esm/utils/misc/eventWrapper.js +11 -0
  182. package/dist/esm/utils/misc/findClosest.js +12 -0
  183. package/dist/esm/utils/misc/getDocumentFromNode.js +8 -0
  184. package/dist/esm/utils/misc/getTreeDiff.js +23 -0
  185. package/dist/esm/utils/misc/getWindow.js +7 -0
  186. package/dist/esm/utils/misc/isDescendantOrSelf.js +12 -0
  187. package/dist/esm/utils/misc/isDisabled.js +30 -0
  188. package/dist/esm/utils/misc/isElementType.js +18 -0
  189. package/dist/esm/utils/misc/isVisible.js +17 -0
  190. package/dist/esm/utils/misc/level.js +15 -0
  191. package/dist/esm/utils/misc/wait.js +12 -0
  192. package/dist/esm/utils/pointer/cssPointerEvents.js +106 -0
  193. package/dist/types/event/createEvent.d.ts +2 -8
  194. package/dist/types/event/eventMap.d.ts +204 -181
  195. package/dist/types/event/index.d.ts +1 -2
  196. package/dist/types/event/types.d.ts +6 -0
  197. package/dist/types/index.d.ts +2 -2
  198. package/dist/types/keyboard/index.d.ts +2 -6
  199. package/dist/types/keyboard/keyMap.d.ts +1 -1
  200. package/dist/types/keyboard/parseKeyDef.d.ts +1 -1
  201. package/dist/types/options.d.ts +4 -4
  202. package/dist/types/pointer/index.d.ts +23 -5
  203. package/dist/types/pointer/keyMap.d.ts +1 -1
  204. package/dist/types/pointer/parseKeyDef.d.ts +1 -1
  205. package/dist/types/setup/config.d.ts +3 -7
  206. package/dist/types/setup/directApi.d.ts +21 -16
  207. package/dist/types/setup/index.d.ts +1 -2
  208. package/dist/types/setup/setup.d.ts +7 -1
  209. package/dist/types/system/index.d.ts +10 -0
  210. package/dist/types/system/keyboard.d.ts +53 -0
  211. package/dist/types/system/pointer/buttons.d.ts +23 -0
  212. package/dist/types/system/pointer/device.d.ts +8 -0
  213. package/dist/types/system/pointer/index.d.ts +39 -0
  214. package/dist/types/system/pointer/mouse.d.ts +26 -0
  215. package/dist/types/system/pointer/pointer.d.ts +30 -0
  216. package/dist/types/utils/click/isClickableInput.d.ts +15 -1
  217. package/dist/types/utils/focus/getActiveElement.d.ts +1 -0
  218. package/dist/types/utils/focus/resolveCaretPosition.d.ts +8 -0
  219. package/dist/types/utils/focus/selection.d.ts +28 -1
  220. package/dist/types/utils/index.d.ts +2 -3
  221. package/dist/types/utils/misc/getTreeDiff.d.ts +1 -0
  222. package/package.json +9 -15
  223. package/dist/index.cjs +0 -3104
  224. package/dist/index.mjs +0 -3155
  225. package/dist/types/event/eventTypes.d.ts +0 -2
  226. package/dist/types/keyboard/keyboardAction.d.ts +0 -10
  227. package/dist/types/keyboard/modifiers.d.ts +0 -9
  228. package/dist/types/keyboard/types.d.ts +0 -73
  229. package/dist/types/pointer/firePointerEvents.d.ts +0 -11
  230. package/dist/types/pointer/pointerAction.d.ts +0 -7
  231. package/dist/types/pointer/pointerMove.d.ts +0 -6
  232. package/dist/types/pointer/pointerPress.d.ts +0 -8
  233. package/dist/types/pointer/resolveSelectionTarget.d.ts +0 -5
  234. package/dist/types/pointer/types.d.ts +0 -62
  235. package/dist/types/utils/keyboard/getKeyEventProps.d.ts +0 -5
  236. package/dist/types/utils/keyboard/getUIEventModifiers.d.ts +0 -15
  237. package/dist/types/utils/pointer/mouseButtons.d.ts +0 -12
@@ -0,0 +1,40 @@
1
+ 'use strict';
2
+
3
+ Object.defineProperty(exports, '__esModule', { value: true });
4
+
5
+ require('../setup/index.js');
6
+ require('../utils/click/isClickableInput.js');
7
+ var Clipboard = require('../utils/dataTransfer/Clipboard.js');
8
+ require('../event/eventMap.js');
9
+ require('../event/behavior/click.js');
10
+ require('../event/behavior/cut.js');
11
+ require('../event/behavior/keydown.js');
12
+ require('../event/behavior/keypress.js');
13
+ require('../event/behavior/keyup.js');
14
+ require('../event/behavior/paste.js');
15
+ require('@testing-library/dom');
16
+ require('../utils/edit/maxLength.js');
17
+ require('../utils/edit/isEditable.js');
18
+ require('@testing-library/dom/dist/helpers.js');
19
+ var copySelection = require('../utils/focus/copySelection.js');
20
+ require('../utils/keyDef/readNextDescriptor.js');
21
+ require('../utils/misc/level.js');
22
+ require('../options.js');
23
+ var config = require('../setup/config.js');
24
+
25
+ async function copy() {
26
+ const doc = this[config.Config].document;
27
+ const target = doc.activeElement ?? /* istanbul ignore next */ doc.body;
28
+ const clipboardData = copySelection.copySelection(target);
29
+ if (clipboardData.items.length === 0) {
30
+ return;
31
+ }
32
+ if (this.dispatchUIEvent(target, 'copy', {
33
+ clipboardData
34
+ }) && this[config.Config].writeToClipboard) {
35
+ await Clipboard.writeDataTransferToClipboard(doc, clipboardData);
36
+ }
37
+ return clipboardData;
38
+ }
39
+
40
+ exports.copy = copy;
@@ -0,0 +1,40 @@
1
+ 'use strict';
2
+
3
+ Object.defineProperty(exports, '__esModule', { value: true });
4
+
5
+ require('../setup/index.js');
6
+ require('../utils/click/isClickableInput.js');
7
+ var Clipboard = require('../utils/dataTransfer/Clipboard.js');
8
+ require('../event/eventMap.js');
9
+ require('../event/behavior/click.js');
10
+ require('../event/behavior/cut.js');
11
+ require('../event/behavior/keydown.js');
12
+ require('../event/behavior/keypress.js');
13
+ require('../event/behavior/keyup.js');
14
+ require('../event/behavior/paste.js');
15
+ require('@testing-library/dom');
16
+ require('../utils/edit/maxLength.js');
17
+ require('../utils/edit/isEditable.js');
18
+ require('@testing-library/dom/dist/helpers.js');
19
+ var copySelection = require('../utils/focus/copySelection.js');
20
+ require('../utils/keyDef/readNextDescriptor.js');
21
+ require('../utils/misc/level.js');
22
+ require('../options.js');
23
+ var config = require('../setup/config.js');
24
+
25
+ async function cut() {
26
+ const doc = this[config.Config].document;
27
+ const target = doc.activeElement ?? /* istanbul ignore next */ doc.body;
28
+ const clipboardData = copySelection.copySelection(target);
29
+ if (clipboardData.items.length === 0) {
30
+ return;
31
+ }
32
+ if (this.dispatchUIEvent(target, 'cut', {
33
+ clipboardData
34
+ }) && this[config.Config].writeToClipboard) {
35
+ await Clipboard.writeDataTransferToClipboard(target.ownerDocument, clipboardData);
36
+ }
37
+ return clipboardData;
38
+ }
39
+
40
+ exports.cut = cut;
@@ -0,0 +1,13 @@
1
+ 'use strict';
2
+
3
+ Object.defineProperty(exports, '__esModule', { value: true });
4
+
5
+ var copy = require('./copy.js');
6
+ var cut = require('./cut.js');
7
+ var paste = require('./paste.js');
8
+
9
+
10
+
11
+ exports.copy = copy.copy;
12
+ exports.cut = cut.cut;
13
+ exports.paste = paste.paste;
@@ -0,0 +1,41 @@
1
+ 'use strict';
2
+
3
+ Object.defineProperty(exports, '__esModule', { value: true });
4
+
5
+ require('../setup/index.js');
6
+ require('../utils/click/isClickableInput.js');
7
+ var DataTransfer = require('../utils/dataTransfer/DataTransfer.js');
8
+ var Clipboard = require('../utils/dataTransfer/Clipboard.js');
9
+ require('../event/eventMap.js');
10
+ require('../event/behavior/click.js');
11
+ require('../event/behavior/cut.js');
12
+ require('../event/behavior/keydown.js');
13
+ require('../event/behavior/keypress.js');
14
+ require('../event/behavior/keyup.js');
15
+ require('../event/behavior/paste.js');
16
+ require('@testing-library/dom');
17
+ require('../utils/edit/maxLength.js');
18
+ require('../utils/edit/isEditable.js');
19
+ var getWindow = require('../utils/misc/getWindow.js');
20
+ require('../utils/keyDef/readNextDescriptor.js');
21
+ require('../utils/misc/level.js');
22
+ require('../options.js');
23
+ var config = require('../setup/config.js');
24
+
25
+ async function paste(clipboardData) {
26
+ const doc = this[config.Config].document;
27
+ const target = doc.activeElement ?? /* istanbul ignore next */ doc.body;
28
+ const dataTransfer = (typeof clipboardData === 'string' ? getClipboardDataFromString(doc, clipboardData) : clipboardData) ?? await Clipboard.readDataTransferFromClipboard(doc).catch(()=>{
29
+ throw new Error('`userEvent.paste()` without `clipboardData` requires the `ClipboardAPI` to be available.');
30
+ });
31
+ this.dispatchUIEvent(target, 'paste', {
32
+ clipboardData: dataTransfer
33
+ });
34
+ }
35
+ function getClipboardDataFromString(doc, text) {
36
+ const dt = DataTransfer.createDataTransfer(getWindow.getWindow(doc));
37
+ dt.setData('text', text);
38
+ return dt;
39
+ }
40
+
41
+ exports.paste = paste;
@@ -0,0 +1,40 @@
1
+ 'use strict';
2
+
3
+ Object.defineProperty(exports, '__esModule', { value: true });
4
+
5
+ require('../setup/index.js');
6
+ var config = require('../setup/config.js');
7
+
8
+ async function click(element) {
9
+ const pointerIn = [];
10
+ if (!this[config.Config].skipHover) {
11
+ pointerIn.push({
12
+ target: element
13
+ });
14
+ }
15
+ pointerIn.push({
16
+ keys: '[MouseLeft]',
17
+ target: element
18
+ });
19
+ return this.pointer(pointerIn);
20
+ }
21
+ async function dblClick(element) {
22
+ return this.pointer([
23
+ {
24
+ target: element
25
+ },
26
+ '[MouseLeft][MouseLeft]'
27
+ ]);
28
+ }
29
+ async function tripleClick(element) {
30
+ return this.pointer([
31
+ {
32
+ target: element
33
+ },
34
+ '[MouseLeft][MouseLeft][MouseLeft]'
35
+ ]);
36
+ }
37
+
38
+ exports.click = click;
39
+ exports.dblClick = dblClick;
40
+ exports.tripleClick = tripleClick;
@@ -0,0 +1,37 @@
1
+ 'use strict';
2
+
3
+ Object.defineProperty(exports, '__esModule', { value: true });
4
+
5
+ require('../setup/index.js');
6
+ require('../utils/click/isClickableInput.js');
7
+ require('../utils/dataTransfer/Clipboard.js');
8
+ require('../event/eventMap.js');
9
+ require('../event/behavior/click.js');
10
+ require('../event/behavior/cut.js');
11
+ require('../event/behavior/keydown.js');
12
+ require('../event/behavior/keypress.js');
13
+ require('../event/behavior/keyup.js');
14
+ require('../event/behavior/paste.js');
15
+ require('@testing-library/dom');
16
+ require('../utils/edit/maxLength.js');
17
+ require('../utils/edit/isEditable.js');
18
+ require('@testing-library/dom/dist/helpers.js');
19
+ require('../utils/keyDef/readNextDescriptor.js');
20
+ require('../utils/misc/level.js');
21
+ var cssPointerEvents = require('../utils/pointer/cssPointerEvents.js');
22
+ var config = require('../setup/config.js');
23
+
24
+ async function hover(element) {
25
+ return this.pointer({
26
+ target: element
27
+ });
28
+ }
29
+ async function unhover(element) {
30
+ cssPointerEvents.assertPointerEvents(this[config.Config], this[config.Config].system.pointer.getMouseTarget(this[config.Config]));
31
+ return this.pointer({
32
+ target: element.ownerDocument.body
33
+ });
34
+ }
35
+
36
+ exports.hover = hover;
37
+ exports.unhover = unhover;
@@ -0,0 +1,16 @@
1
+ 'use strict';
2
+
3
+ Object.defineProperty(exports, '__esModule', { value: true });
4
+
5
+ var click = require('./click.js');
6
+ var hover = require('./hover.js');
7
+ var tab = require('./tab.js');
8
+
9
+
10
+
11
+ exports.click = click.click;
12
+ exports.dblClick = click.dblClick;
13
+ exports.tripleClick = click.tripleClick;
14
+ exports.hover = hover.hover;
15
+ exports.unhover = hover.unhover;
16
+ exports.tab = tab.tab;
@@ -0,0 +1,9 @@
1
+ 'use strict';
2
+
3
+ Object.defineProperty(exports, '__esModule', { value: true });
4
+
5
+ async function tab({ shift } = {}) {
6
+ return this.keyboard(shift === true ? '{Shift>}{Tab}{/Shift}' : shift === false ? '[/ShiftLeft][/ShiftRight]{Tab}' : '{Tab}');
7
+ }
8
+
9
+ exports.tab = tab;
@@ -0,0 +1,74 @@
1
+ 'use strict';
2
+
3
+ Object.defineProperty(exports, '__esModule', { value: true });
4
+
5
+ var index = require('../event/index.js');
6
+ require('../utils/click/isClickableInput.js');
7
+ require('../utils/dataTransfer/Clipboard.js');
8
+ require('../utils/edit/maxLength.js');
9
+ require('../utils/edit/isEditable.js');
10
+ require('@testing-library/dom');
11
+ var isElementType = require('../utils/misc/isElementType.js');
12
+ require('@testing-library/dom/dist/helpers.js');
13
+ require('../utils/keyDef/readNextDescriptor.js');
14
+ require('../utils/misc/level.js');
15
+ require('../options.js');
16
+ var selection = require('./selection.js');
17
+ var setRangeText = require('./setRangeText.js');
18
+ var value = require('./value.js');
19
+
20
+ const isPrepared = Symbol('Node prepared with document state workarounds');
21
+ function prepareDocument(document) {
22
+ if (document[isPrepared]) {
23
+ return;
24
+ }
25
+ document.addEventListener('focus', (e)=>{
26
+ const el = e.target;
27
+ prepareElement(el);
28
+ }, {
29
+ capture: true,
30
+ passive: true
31
+ });
32
+ // Our test environment defaults to `document.body` as `activeElement`.
33
+ // In other environments this might be `null` when preparing.
34
+ // istanbul ignore else
35
+ if (document.activeElement) {
36
+ prepareElement(document.activeElement);
37
+ }
38
+ document.addEventListener('blur', (e)=>{
39
+ const el = e.target;
40
+ const initialValue = value.getInitialValue(el);
41
+ if (initialValue !== undefined) {
42
+ if (el.value !== initialValue) {
43
+ index.dispatchUIEvent({}, el, 'change');
44
+ }
45
+ value.clearInitialValue(el);
46
+ }
47
+ }, {
48
+ capture: true,
49
+ passive: true
50
+ });
51
+ document[isPrepared] = isPrepared;
52
+ }
53
+ function prepareElement(el) {
54
+ if (el[isPrepared]) {
55
+ return;
56
+ }
57
+ if (isElementType.isElementType(el, [
58
+ 'input',
59
+ 'textarea'
60
+ ])) {
61
+ value.prepareValueInterceptor(el);
62
+ selection.prepareSelectionInterceptor(el);
63
+ setRangeText.prepareRangeTextInterceptor(el);
64
+ }
65
+ el[isPrepared] = isPrepared;
66
+ }
67
+
68
+ exports.getUISelection = selection.getUISelection;
69
+ exports.setUISelection = selection.setUISelection;
70
+ exports.clearInitialValue = value.clearInitialValue;
71
+ exports.commitValueAfterInput = value.commitValueAfterInput;
72
+ exports.getUIValue = value.getUIValue;
73
+ exports.setUIValue = value.setUIValue;
74
+ exports.prepareDocument = prepareDocument;
@@ -0,0 +1,30 @@
1
+ 'use strict';
2
+
3
+ Object.defineProperty(exports, '__esModule', { value: true });
4
+
5
+ const Interceptor = Symbol('Interceptor for programmatical calls');
6
+ function prepareInterceptor(element, propName, interceptorImpl) {
7
+ const prototypeDescriptor = Object.getOwnPropertyDescriptor(element.constructor.prototype, propName);
8
+ const objectDescriptor = Object.getOwnPropertyDescriptor(element, propName);
9
+ const target = prototypeDescriptor?.set ? 'set' : 'value';
10
+ /* istanbul ignore if */ if (typeof prototypeDescriptor?.[target] !== 'function' || prototypeDescriptor[target][Interceptor]) {
11
+ throw new Error(`Element ${element.tagName} does not implement "${String(propName)}".`);
12
+ }
13
+ function intercept(...args) {
14
+ const { applyNative =false , realArgs , then , } = interceptorImpl.call(this, ...args);
15
+ const realFunc = (!applyNative && objectDescriptor || prototypeDescriptor)[target];
16
+ if (target === 'set') {
17
+ realFunc.call(this, realArgs);
18
+ } else {
19
+ realFunc.call(this, ...realArgs);
20
+ }
21
+ then?.();
22
+ }
23
+ intercept[Interceptor] = Interceptor;
24
+ Object.defineProperty(element, propName, {
25
+ ...objectDescriptor ?? prototypeDescriptor,
26
+ [target]: intercept
27
+ });
28
+ }
29
+
30
+ exports.prepareInterceptor = prepareInterceptor;
@@ -0,0 +1,107 @@
1
+ 'use strict';
2
+
3
+ Object.defineProperty(exports, '__esModule', { value: true });
4
+
5
+ require('../utils/click/isClickableInput.js');
6
+ require('../utils/dataTransfer/Clipboard.js');
7
+ require('../utils/edit/maxLength.js');
8
+ require('../utils/edit/isEditable.js');
9
+ require('@testing-library/dom');
10
+ require('@testing-library/dom/dist/helpers.js');
11
+ require('../utils/keyDef/readNextDescriptor.js');
12
+ require('../utils/misc/level.js');
13
+ require('../options.js');
14
+ require('../event/eventMap.js');
15
+ require('../event/behavior/click.js');
16
+ require('../event/behavior/cut.js');
17
+ require('../event/behavior/keydown.js');
18
+ require('../event/behavior/keypress.js');
19
+ require('../event/behavior/keyup.js');
20
+ require('../event/behavior/paste.js');
21
+ var interceptor = require('./interceptor.js');
22
+ var value = require('./value.js');
23
+
24
+ const UISelection = Symbol('Displayed selection in UI');
25
+ function prepareSelectionInterceptor(element) {
26
+ interceptor.prepareInterceptor(element, 'setSelectionRange', function interceptorImpl(start, ...others) {
27
+ const isUI = start && typeof start === 'object' && start[UISelection];
28
+ if (!isUI) {
29
+ this[UISelection] = undefined;
30
+ }
31
+ return {
32
+ applyNative: !!isUI,
33
+ realArgs: [
34
+ Number(start),
35
+ ...others
36
+ ]
37
+ };
38
+ });
39
+ interceptor.prepareInterceptor(element, 'selectionStart', function interceptorImpl(v) {
40
+ this[UISelection] = undefined;
41
+ return {
42
+ realArgs: v
43
+ };
44
+ });
45
+ interceptor.prepareInterceptor(element, 'selectionEnd', function interceptorImpl(v) {
46
+ this[UISelection] = undefined;
47
+ return {
48
+ realArgs: v
49
+ };
50
+ });
51
+ interceptor.prepareInterceptor(element, 'select', function interceptorImpl() {
52
+ this[UISelection] = {
53
+ anchorOffset: 0,
54
+ focusOffset: value.getUIValue(element).length
55
+ };
56
+ return {
57
+ realArgs: []
58
+ };
59
+ });
60
+ }
61
+ function setUISelection(element, { focusOffset: focusOffsetParam , anchorOffset: anchorOffsetParam = focusOffsetParam }, mode = 'replace') {
62
+ const valueLength = value.getUIValue(element).length;
63
+ const sanitizeOffset = (o)=>Math.max(0, Math.min(valueLength, o));
64
+ const anchorOffset = mode === 'replace' || element[UISelection] === undefined ? sanitizeOffset(anchorOffsetParam) : element[UISelection].anchorOffset;
65
+ const focusOffset = sanitizeOffset(focusOffsetParam);
66
+ const startOffset = Math.min(anchorOffset, focusOffset);
67
+ const endOffset = Math.max(anchorOffset, focusOffset);
68
+ element[UISelection] = {
69
+ anchorOffset,
70
+ focusOffset
71
+ };
72
+ if (element.selectionStart === startOffset && element.selectionEnd === endOffset) {
73
+ return;
74
+ }
75
+ // eslint-disable-next-line no-new-wrappers
76
+ const startObj = new Number(startOffset);
77
+ startObj[UISelection] = UISelection;
78
+ try {
79
+ element.setSelectionRange(startObj, endOffset);
80
+ } catch {
81
+ // DOMException for invalid state is expected when calling this
82
+ // on an element without support for setSelectionRange
83
+ }
84
+ }
85
+ function getUISelection(element) {
86
+ const sel = element[UISelection] ?? {
87
+ anchorOffset: element.selectionStart ?? 0,
88
+ focusOffset: element.selectionEnd ?? 0
89
+ };
90
+ return {
91
+ ...sel,
92
+ startOffset: Math.min(sel.anchorOffset, sel.focusOffset),
93
+ endOffset: Math.max(sel.anchorOffset, sel.focusOffset)
94
+ };
95
+ }
96
+ function hasUISelection(element) {
97
+ return !!element[UISelection];
98
+ }
99
+ /** Flag the IDL selection as clean. This does not change the selection. */ function setUISelectionClean(element) {
100
+ element[UISelection] = undefined;
101
+ }
102
+
103
+ exports.getUISelection = getUISelection;
104
+ exports.hasUISelection = hasUISelection;
105
+ exports.prepareSelectionInterceptor = prepareSelectionInterceptor;
106
+ exports.setUISelection = setUISelection;
107
+ exports.setUISelectionClean = setUISelectionClean;
@@ -0,0 +1,21 @@
1
+ 'use strict';
2
+
3
+ Object.defineProperty(exports, '__esModule', { value: true });
4
+
5
+ var interceptor = require('./interceptor.js');
6
+ var selection = require('./selection.js');
7
+ var value = require('./value.js');
8
+
9
+ function prepareRangeTextInterceptor(element) {
10
+ interceptor.prepareInterceptor(element, 'setRangeText', function interceptorImpl(...realArgs) {
11
+ return {
12
+ realArgs,
13
+ then: ()=>{
14
+ value.setUIValueClean(element);
15
+ selection.setUISelectionClean(element);
16
+ }
17
+ };
18
+ });
19
+ }
20
+
21
+ exports.prepareRangeTextInterceptor = prepareRangeTextInterceptor;
@@ -0,0 +1,125 @@
1
+ 'use strict';
2
+
3
+ Object.defineProperty(exports, '__esModule', { value: true });
4
+
5
+ require('../utils/click/isClickableInput.js');
6
+ require('../utils/dataTransfer/Clipboard.js');
7
+ require('../event/eventMap.js');
8
+ require('../event/behavior/click.js');
9
+ require('../event/behavior/cut.js');
10
+ require('../event/behavior/keydown.js');
11
+ require('../event/behavior/keypress.js');
12
+ require('../event/behavior/keyup.js');
13
+ require('../event/behavior/paste.js');
14
+ require('@testing-library/dom');
15
+ var selection = require('./selection.js');
16
+ var interceptor = require('./interceptor.js');
17
+ require('../utils/edit/maxLength.js');
18
+ require('../utils/edit/isEditable.js');
19
+ var isElementType = require('../utils/misc/isElementType.js');
20
+ var getWindow = require('../utils/misc/getWindow.js');
21
+ require('../utils/keyDef/readNextDescriptor.js');
22
+ require('../utils/misc/level.js');
23
+ require('../options.js');
24
+
25
+ const UIValue = Symbol('Displayed value in UI');
26
+ const InitialValue = Symbol('Initial value to compare on blur');
27
+ const TrackChanges = Symbol('Track programmatic changes for React workaround');
28
+ function valueInterceptor(v) {
29
+ const isUI = typeof v === 'object' && v[UIValue];
30
+ if (isUI) {
31
+ this[UIValue] = String(v);
32
+ startTrackValue(this);
33
+ }
34
+ return {
35
+ applyNative: !!isUI,
36
+ realArgs: sanitizeValue(this, v),
37
+ then: isUI ? undefined : ()=>trackOrSetValue(this, String(v))
38
+ };
39
+ }
40
+ function sanitizeValue(element, v) {
41
+ // Workaround for JSDOM
42
+ if (isElementType.isElementType(element, 'input', {
43
+ type: 'number'
44
+ }) && String(v) !== '' && !Number.isNaN(Number(v))) {
45
+ // Setting value to "1." results in `null` in JSDOM
46
+ return String(Number(v));
47
+ }
48
+ return String(v);
49
+ }
50
+ function prepareValueInterceptor(element) {
51
+ interceptor.prepareInterceptor(element, 'value', valueInterceptor);
52
+ }
53
+ function setUIValue(element, value) {
54
+ if (element[InitialValue] === undefined) {
55
+ element[InitialValue] = element.value;
56
+ }
57
+ element.value = {
58
+ [UIValue]: UIValue,
59
+ toString: ()=>value
60
+ };
61
+ }
62
+ function getUIValue(element) {
63
+ return element[UIValue] === undefined ? element.value : String(element[UIValue]);
64
+ }
65
+ /** Flag the IDL value as clean. This does not change the value.*/ function setUIValueClean(element) {
66
+ element[UIValue] = undefined;
67
+ }
68
+ function clearInitialValue(element) {
69
+ element[InitialValue] = undefined;
70
+ }
71
+ function getInitialValue(element) {
72
+ return element[InitialValue];
73
+ }
74
+ // When the input event happens in the browser, React executes all event handlers
75
+ // and if they change state of a controlled value, nothing happens.
76
+ // But when we trigger the event handlers in test environment with React@17,
77
+ // the changes are rolled back before the state update is applied.
78
+ // This results in a reset cursor.
79
+ // There might be a better way to work around if we figure out
80
+ // why the batched update is executed differently in our test environment.
81
+ function isReact17Element(element) {
82
+ return Object.getOwnPropertyNames(element).some((k)=>k.startsWith('__react')) && getWindow.getWindow(element).REACT_VERSION === 17;
83
+ }
84
+ function startTrackValue(element) {
85
+ if (!isReact17Element(element)) {
86
+ return;
87
+ }
88
+ element[TrackChanges] = {
89
+ previousValue: String(element.value),
90
+ tracked: []
91
+ };
92
+ }
93
+ function trackOrSetValue(element, v) {
94
+ element[TrackChanges]?.tracked?.push(v);
95
+ if (!element[TrackChanges]) {
96
+ setUIValueClean(element);
97
+ selection.setUISelection(element, {
98
+ focusOffset: v.length
99
+ });
100
+ }
101
+ }
102
+ function commitValueAfterInput(element, cursorOffset) {
103
+ const changes = element[TrackChanges];
104
+ element[TrackChanges] = undefined;
105
+ if (!changes?.tracked?.length) {
106
+ return;
107
+ }
108
+ const isJustReactStateUpdate = changes.tracked.length === 2 && changes.tracked[0] === changes.previousValue && changes.tracked[1] === element.value;
109
+ if (!isJustReactStateUpdate) {
110
+ setUIValueClean(element);
111
+ }
112
+ if (selection.hasUISelection(element)) {
113
+ selection.setUISelection(element, {
114
+ focusOffset: isJustReactStateUpdate ? cursorOffset : element.value.length
115
+ });
116
+ }
117
+ }
118
+
119
+ exports.clearInitialValue = clearInitialValue;
120
+ exports.commitValueAfterInput = commitValueAfterInput;
121
+ exports.getInitialValue = getInitialValue;
122
+ exports.getUIValue = getUIValue;
123
+ exports.prepareValueInterceptor = prepareValueInterceptor;
124
+ exports.setUIValue = setUIValue;
125
+ exports.setUIValueClean = setUIValueClean;
@@ -0,0 +1,42 @@
1
+ 'use strict';
2
+
3
+ require('../../utils/click/isClickableInput.js');
4
+ require('../../utils/dataTransfer/Clipboard.js');
5
+ require('../eventMap.js');
6
+ var dispatchEvent = require('../dispatchEvent.js');
7
+ require('../../utils/edit/maxLength.js');
8
+ require('../../utils/edit/isEditable.js');
9
+ var focus = require('../../utils/focus/focus.js');
10
+ var getWindow = require('../../utils/misc/getWindow.js');
11
+ var isElementType = require('../../utils/misc/isElementType.js');
12
+ var blur = require('../../utils/focus/blur.js');
13
+ var isFocusable = require('../../utils/focus/isFocusable.js');
14
+ require('../../utils/keyDef/readNextDescriptor.js');
15
+ var cloneEvent = require('../../utils/misc/cloneEvent.js');
16
+ require('@testing-library/dom');
17
+ require('../../utils/misc/level.js');
18
+ require('../../options.js');
19
+ var registry = require('./registry.js');
20
+
21
+ registry.behavior.click = (event, target, config)=>{
22
+ const context = target.closest('button,input,label,select,textarea');
23
+ const control = context && isElementType.isElementType(context, 'label') && context.control;
24
+ if (control) {
25
+ return ()=>{
26
+ if (isFocusable.isFocusable(control)) {
27
+ focus.focus(control);
28
+ }
29
+ dispatchEvent.dispatchEvent(config, control, cloneEvent.cloneEvent(event));
30
+ };
31
+ } else if (isElementType.isElementType(target, 'input', {
32
+ type: 'file'
33
+ })) {
34
+ return ()=>{
35
+ // blur fires when the file selector pops up
36
+ blur.blur(target);
37
+ target.dispatchEvent(new (getWindow.getWindow(target)).Event('fileDialog'));
38
+ // focus fires after the file selector has been closed
39
+ focus.focus(target);
40
+ };
41
+ }
42
+ };
@@ -0,0 +1,26 @@
1
+ 'use strict';
2
+
3
+ require('../../utils/click/isClickableInput.js');
4
+ require('../../utils/dataTransfer/Clipboard.js');
5
+ require('../eventMap.js');
6
+ require('./click.js');
7
+ require('./keydown.js');
8
+ require('./keypress.js');
9
+ require('./keyup.js');
10
+ require('./paste.js');
11
+ var registry = require('./registry.js');
12
+ require('@testing-library/dom');
13
+ var input = require('../../utils/edit/input.js');
14
+ var isEditable = require('../../utils/edit/isEditable.js');
15
+ require('@testing-library/dom/dist/helpers.js');
16
+ require('../../utils/keyDef/readNextDescriptor.js');
17
+ require('../../utils/misc/level.js');
18
+ require('../../options.js');
19
+
20
+ registry.behavior.cut = (event, target, config)=>{
21
+ return ()=>{
22
+ if (isEditable.isEditable(target)) {
23
+ input.input(config, target, '', 'deleteByCut');
24
+ }
25
+ };
26
+ };