@testing-library/user-event 14.0.0-alpha.9 → 14.0.0-beta.4

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 (140) hide show
  1. package/dist/index.d.ts +1110 -8
  2. package/dist/index.js +2824 -15
  3. package/dist/package.json +1 -0
  4. package/package.json +6 -30
  5. package/dist/clear.d.ts +0 -2
  6. package/dist/clear.js +0 -46
  7. package/dist/click.d.ts +0 -9
  8. package/dist/click.js +0 -62
  9. package/dist/document/index.d.ts +0 -10
  10. package/dist/document/index.js +0 -100
  11. package/dist/document/interceptor.d.ts +0 -15
  12. package/dist/document/interceptor.js +0 -37
  13. package/dist/document/selection.d.ts +0 -27
  14. package/dist/document/selection.js +0 -90
  15. package/dist/document/value.d.ts +0 -18
  16. package/dist/document/value.js +0 -77
  17. package/dist/hover.d.ts +0 -4
  18. package/dist/hover.js +0 -43
  19. package/dist/keyboard/getEventProps.d.ts +0 -17
  20. package/dist/keyboard/getEventProps.js +0 -33
  21. package/dist/keyboard/getNextKeyDef.d.ts +0 -19
  22. package/dist/keyboard/getNextKeyDef.js +0 -85
  23. package/dist/keyboard/index.d.ts +0 -19
  24. package/dist/keyboard/index.js +0 -78
  25. package/dist/keyboard/keyMap.d.ts +0 -5
  26. package/dist/keyboard/keyMap.js +0 -143
  27. package/dist/keyboard/keyboardImplementation.d.ts +0 -3
  28. package/dist/keyboard/keyboardImplementation.js +0 -169
  29. package/dist/keyboard/plugins/arrow.d.ts +0 -6
  30. package/dist/keyboard/plugins/arrow.js +0 -28
  31. package/dist/keyboard/plugins/character.d.ts +0 -5
  32. package/dist/keyboard/plugins/character.js +0 -166
  33. package/dist/keyboard/plugins/combination.d.ts +0 -5
  34. package/dist/keyboard/plugins/combination.js +0 -17
  35. package/dist/keyboard/plugins/control.d.ts +0 -6
  36. package/dist/keyboard/plugins/control.js +0 -52
  37. package/dist/keyboard/plugins/functional.d.ts +0 -11
  38. package/dist/keyboard/plugins/functional.js +0 -140
  39. package/dist/keyboard/plugins/index.d.ts +0 -8
  40. package/dist/keyboard/plugins/index.js +0 -42
  41. package/dist/keyboard/shared/fireChangeForInputTimeIfValid.d.ts +0 -3
  42. package/dist/keyboard/shared/fireChangeForInputTimeIfValid.js +0 -20
  43. package/dist/keyboard/shared/index.d.ts +0 -1
  44. package/dist/keyboard/shared/index.js +0 -18
  45. package/dist/keyboard/specialCharMap.d.ts +0 -22
  46. package/dist/keyboard/specialCharMap.js +0 -30
  47. package/dist/keyboard/types.d.ts +0 -80
  48. package/dist/keyboard/types.js +0 -19
  49. package/dist/paste.d.ts +0 -7
  50. package/dist/paste.js +0 -60
  51. package/dist/pointer/index.d.ts +0 -18
  52. package/dist/pointer/index.js +0 -90
  53. package/dist/pointer/keyMap.d.ts +0 -2
  54. package/dist/pointer/keyMap.js +0 -29
  55. package/dist/pointer/parseKeyDef.d.ts +0 -6
  56. package/dist/pointer/parseKeyDef.js +0 -36
  57. package/dist/pointer/pointerAction.d.ts +0 -6
  58. package/dist/pointer/pointerAction.js +0 -52
  59. package/dist/pointer/pointerMove.d.ts +0 -5
  60. package/dist/pointer/pointerMove.js +0 -136
  61. package/dist/pointer/pointerPress.d.ts +0 -7
  62. package/dist/pointer/pointerPress.js +0 -330
  63. package/dist/pointer/resolveSelectionTarget.d.ts +0 -5
  64. package/dist/pointer/resolveSelectionTarget.js +0 -75
  65. package/dist/pointer/types.d.ts +0 -72
  66. package/dist/pointer/types.js +0 -1
  67. package/dist/selectOptions.d.ts +0 -4
  68. package/dist/selectOptions.js +0 -142
  69. package/dist/setup.d.ts +0 -92
  70. package/dist/setup.js +0 -203
  71. package/dist/tab.d.ts +0 -5
  72. package/dist/tab.js +0 -12
  73. package/dist/type.d.ts +0 -14
  74. package/dist/type.js +0 -74
  75. package/dist/upload.d.ts +0 -10
  76. package/dist/upload.js +0 -92
  77. package/dist/utils/click/isClickableInput.d.ts +0 -1
  78. package/dist/utils/click/isClickableInput.js +0 -14
  79. package/dist/utils/edit/buildTimeValue.d.ts +0 -1
  80. package/dist/utils/edit/buildTimeValue.js +0 -44
  81. package/dist/utils/edit/calculateNewValue.d.ts +0 -16
  82. package/dist/utils/edit/calculateNewValue.js +0 -50
  83. package/dist/utils/edit/fireInputEvent.d.ts +0 -11
  84. package/dist/utils/edit/fireInputEvent.js +0 -65
  85. package/dist/utils/edit/getValue.d.ts +0 -1
  86. package/dist/utils/edit/getValue.js +0 -23
  87. package/dist/utils/edit/isContentEditable.d.ts +0 -7
  88. package/dist/utils/edit/isContentEditable.js +0 -25
  89. package/dist/utils/edit/isEditable.d.ts +0 -25
  90. package/dist/utils/edit/isEditable.js +0 -42
  91. package/dist/utils/edit/isValidDateValue.d.ts +0 -3
  92. package/dist/utils/edit/isValidDateValue.js +0 -12
  93. package/dist/utils/edit/isValidInputTimeValue.d.ts +0 -3
  94. package/dist/utils/edit/isValidInputTimeValue.js +0 -12
  95. package/dist/utils/edit/maxLength.d.ts +0 -1
  96. package/dist/utils/edit/maxLength.js +0 -50
  97. package/dist/utils/edit/prepareInput.d.ts +0 -4
  98. package/dist/utils/edit/prepareInput.js +0 -60
  99. package/dist/utils/focus/blur.d.ts +0 -2
  100. package/dist/utils/focus/blur.js +0 -19
  101. package/dist/utils/focus/focus.d.ts +0 -2
  102. package/dist/utils/focus/focus.js +0 -22
  103. package/dist/utils/focus/getActiveElement.d.ts +0 -1
  104. package/dist/utils/focus/getActiveElement.js +0 -26
  105. package/dist/utils/focus/getTabDestination.d.ts +0 -1
  106. package/dist/utils/focus/getTabDestination.js +0 -71
  107. package/dist/utils/focus/isFocusable.d.ts +0 -1
  108. package/dist/utils/focus/isFocusable.js +0 -12
  109. package/dist/utils/focus/selectAll.d.ts +0 -4
  110. package/dist/utils/focus/selectAll.js +0 -38
  111. package/dist/utils/focus/selection.d.ts +0 -42
  112. package/dist/utils/focus/selection.js +0 -190
  113. package/dist/utils/focus/selector.d.ts +0 -1
  114. package/dist/utils/focus/selector.js +0 -8
  115. package/dist/utils/index.d.ts +0 -31
  116. package/dist/utils/index.js +0 -408
  117. package/dist/utils/keyDef/readNextDescriptor.d.ts +0 -19
  118. package/dist/utils/keyDef/readNextDescriptor.js +0 -102
  119. package/dist/utils/misc/eventWrapper.d.ts +0 -1
  120. package/dist/utils/misc/eventWrapper.js +0 -16
  121. package/dist/utils/misc/findClosest.d.ts +0 -1
  122. package/dist/utils/misc/findClosest.js +0 -20
  123. package/dist/utils/misc/hasFormSubmit.d.ts +0 -1
  124. package/dist/utils/misc/hasFormSubmit.js +0 -10
  125. package/dist/utils/misc/hasPointerEvents.d.ts +0 -15
  126. package/dist/utils/misc/hasPointerEvents.js +0 -24
  127. package/dist/utils/misc/isDescendantOrSelf.d.ts +0 -1
  128. package/dist/utils/misc/isDescendantOrSelf.js +0 -20
  129. package/dist/utils/misc/isDisabled.d.ts +0 -1
  130. package/dist/utils/misc/isDisabled.js +0 -12
  131. package/dist/utils/misc/isElementType.d.ts +0 -5
  132. package/dist/utils/misc/isElementType.js +0 -24
  133. package/dist/utils/misc/isVisible.d.ts +0 -1
  134. package/dist/utils/misc/isVisible.js +0 -24
  135. package/dist/utils/misc/wait.d.ts +0 -1
  136. package/dist/utils/misc/wait.js +0 -10
  137. package/dist/utils/pointer/firePointerEvents.d.ts +0 -25
  138. package/dist/utils/pointer/firePointerEvents.js +0 -112
  139. package/dist/utils/pointer/mouseButtons.d.ts +0 -12
  140. package/dist/utils/pointer/mouseButtons.js +0 -45
@@ -1,330 +0,0 @@
1
- "use strict";
2
-
3
- Object.defineProperty(exports, "__esModule", {
4
- value: true
5
- });
6
- exports.pointerPress = pointerPress;
7
-
8
- var _dom = require("@testing-library/dom");
9
-
10
- var _utils = require("../utils");
11
-
12
- var _document = require("../document");
13
-
14
- var _resolveSelectionTarget = require("./resolveSelectionTarget");
15
-
16
- /* eslint-disable complexity */
17
- async function pointerPress(action, state) {
18
- const {
19
- keyDef,
20
- target,
21
- releasePrevious,
22
- releaseSelf
23
- } = action;
24
- const previous = state.pointerState.pressed.find(p => p.keyDef === keyDef);
25
- const pointerName = keyDef.pointerType === 'touch' ? keyDef.name : keyDef.pointerType;
26
- const targetIsDisabled = (0, _utils.isDisabled)(target);
27
-
28
- if (previous) {
29
- up(state, pointerName, action, previous, targetIsDisabled);
30
- }
31
-
32
- if (!releasePrevious) {
33
- const press = down(state, pointerName, action, targetIsDisabled);
34
-
35
- if (releaseSelf) {
36
- up(state, pointerName, action, press, targetIsDisabled);
37
- }
38
- }
39
- }
40
-
41
- function getNextPointerId(state) {
42
- state.pointerId = state.pointerId + 1;
43
- return state.pointerId;
44
- }
45
-
46
- function down({
47
- pointerState,
48
- keyboardState
49
- }, pointerName, {
50
- keyDef,
51
- node,
52
- offset,
53
- target,
54
- coords
55
- }, targetIsDisabled) {
56
- var _pointerState$activeC, _pointerState$activeC2, _pointerState$activeC3;
57
-
58
- const {
59
- name,
60
- pointerType,
61
- button
62
- } = keyDef;
63
- const pointerId = pointerType === 'mouse' ? 1 : getNextPointerId(pointerState);
64
- pointerState.position[pointerName] = { ...pointerState.position[pointerName],
65
- pointerId,
66
- pointerType,
67
- target,
68
- coords
69
- };
70
- let isMultiTouch = false;
71
- let isPrimary = true;
72
-
73
- if (pointerType !== 'mouse') {
74
- for (const obj of pointerState.pressed) {
75
- // TODO: test multi device input across browsers
76
- // istanbul ignore else
77
- if (obj.keyDef.pointerType === pointerType) {
78
- obj.isMultiTouch = true;
79
- isMultiTouch = true;
80
- isPrimary = false;
81
- }
82
- }
83
- }
84
-
85
- if (((_pointerState$activeC = pointerState.activeClickCount) == null ? void 0 : _pointerState$activeC[0]) !== name) {
86
- delete pointerState.activeClickCount;
87
- }
88
-
89
- const clickCount = Number((_pointerState$activeC2 = (_pointerState$activeC3 = pointerState.activeClickCount) == null ? void 0 : _pointerState$activeC3[1]) != null ? _pointerState$activeC2 : 0) + 1;
90
- pointerState.activeClickCount = [name, clickCount];
91
- const pressObj = {
92
- keyDef,
93
- downTarget: target,
94
- pointerId,
95
- unpreventedDefault: true,
96
- isMultiTouch,
97
- isPrimary,
98
- clickCount
99
- };
100
- pointerState.pressed.push(pressObj);
101
-
102
- if (!targetIsDisabled) {
103
- if (pointerType !== 'mouse') {
104
- fire('pointerover');
105
- fire('pointerenter');
106
- }
107
-
108
- if (pointerType !== 'mouse' || !pointerState.pressed.some(p => p.keyDef !== keyDef && p.keyDef.pointerType === pointerType)) {
109
- fire('pointerdown');
110
- }
111
-
112
- if (pointerType === 'mouse') {
113
- pressObj.unpreventedDefault = fire('mousedown');
114
- } // TODO: touch...
115
-
116
- }
117
-
118
- if (pointerType === 'mouse' && pressObj.unpreventedDefault) {
119
- mousedownDefaultBehavior({
120
- target,
121
- targetIsDisabled,
122
- clickCount,
123
- position: pointerState.position[pointerName],
124
- node,
125
- offset
126
- });
127
- }
128
-
129
- return pressObj;
130
-
131
- function fire(type) {
132
- return (0, _utils.firePointerEvent)(target, type, {
133
- pointerState,
134
- keyboardState,
135
- button,
136
- clickCount,
137
- coords,
138
- isPrimary,
139
- pointerId,
140
- pointerType
141
- });
142
- }
143
- }
144
-
145
- function up({
146
- pointerState,
147
- keyboardState
148
- }, pointerName, {
149
- keyDef: {
150
- pointerType,
151
- button
152
- },
153
- target,
154
- coords,
155
- node,
156
- offset
157
- }, pressed, targetIsDisabled) {
158
- pointerState.pressed = pointerState.pressed.filter(p => p !== pressed);
159
- const {
160
- isMultiTouch,
161
- isPrimary,
162
- pointerId,
163
- clickCount
164
- } = pressed;
165
- let {
166
- unpreventedDefault
167
- } = pressed;
168
- pointerState.position[pointerName] = { ...pointerState.position[pointerName],
169
- target,
170
- coords
171
- }; // TODO: pointerleave for touch device
172
-
173
- if (!targetIsDisabled) {
174
- if (pointerType !== 'mouse' || !pointerState.pressed.filter(p => p.keyDef.pointerType === pointerType).length) {
175
- fire('pointerup');
176
- }
177
-
178
- if (pointerType !== 'mouse') {
179
- fire('pointerout');
180
- fire('pointerleave');
181
- }
182
-
183
- if (pointerType !== 'mouse' && !isMultiTouch) {
184
- if (clickCount === 1) {
185
- fire('mouseover');
186
- fire('mouseenter');
187
- }
188
-
189
- fire('mousemove');
190
- unpreventedDefault = fire('mousedown') && unpreventedDefault;
191
- }
192
- }
193
-
194
- if (unpreventedDefault && pointerType !== 'mouse' && !isMultiTouch) {
195
- mousedownDefaultBehavior({
196
- target,
197
- targetIsDisabled,
198
- clickCount,
199
- position: pointerState.position[pointerName],
200
- node,
201
- offset
202
- });
203
- }
204
-
205
- delete pointerState.position[pointerName].selectionRange;
206
-
207
- if (!targetIsDisabled) {
208
- if (pointerType === 'mouse' || !isMultiTouch) {
209
- unpreventedDefault = fire('mouseup') && unpreventedDefault;
210
- const canClick = pointerType !== 'mouse' || button === 'primary';
211
-
212
- if (canClick && target === pressed.downTarget) {
213
- fire('click');
214
-
215
- if (clickCount === 2) {
216
- fire('dblclick');
217
- } // If the click happens inside a `label` with a control, the control (or closes focusable) is focused.
218
-
219
-
220
- const label = target.closest('label');
221
-
222
- if (label != null && label.control) {
223
- var _findClosest;
224
-
225
- (0, _utils.focus)((_findClosest = (0, _utils.findClosest)(label.control, _utils.isFocusable)) != null ? _findClosest : target.ownerDocument.body);
226
- }
227
- }
228
-
229
- if (pointerType === 'mouse' && button === 'secondary') {
230
- _dom.fireEvent.contextMenu(target);
231
- }
232
- }
233
- }
234
-
235
- function fire(type) {
236
- return (0, _utils.firePointerEvent)(target, type, {
237
- pointerState,
238
- keyboardState,
239
- button,
240
- clickCount,
241
- coords,
242
- isPrimary,
243
- pointerId,
244
- pointerType
245
- });
246
- }
247
- }
248
-
249
- function mousedownDefaultBehavior({
250
- position,
251
- target,
252
- targetIsDisabled,
253
- clickCount,
254
- node,
255
- offset
256
- }) {
257
- var _findClosest2;
258
-
259
- // The closest focusable element is focused when a `mousedown` would have been fired.
260
- // Even if there was no `mousedown` because the element was disabled.
261
- // A `mousedown` that preventsDefault cancels this though.
262
- (0, _utils.focus)((_findClosest2 = (0, _utils.findClosest)(target, _utils.isFocusable)) != null ? _findClosest2 : target.ownerDocument.body); // TODO: What happens if a focus event handler interfers?
263
- // An unprevented mousedown moves the cursor to the closest character.
264
- // We try to approximate the behavior for a no-layout environment.
265
-
266
- if (!targetIsDisabled) {
267
- const hasValue = (0, _utils.isElementType)(target, ['input', 'textarea']); // On non-input elements the text selection per multiple click
268
- // can extend beyond the target boundaries.
269
- // The exact mechanism what is considered in the same line is unclear.
270
- // Looks it might be every inline element.
271
- // TODO: Check what might be considered part of the same line of text.
272
-
273
- const text = String(hasValue ? (0, _document.getUIValue)(target) : target.textContent);
274
- const [start, end] = node ? // As offset is describing a DOMOffset it is non-trivial to determine
275
- // which elements might be considered in the same line of text.
276
- // TODO: support expanding initial range on multiple clicks if node is given
277
- [offset, offset] : getTextRange(text, offset, clickCount); // TODO: implement modifying selection per shift/ctrl+mouse
278
-
279
- if (hasValue) {
280
- (0, _document.setUISelection)(target, {
281
- anchorOffset: start != null ? start : text.length,
282
- focusOffset: end != null ? end : text.length
283
- });
284
- position.selectionRange = {
285
- node: target,
286
- start: start != null ? start : 0,
287
- end: end != null ? end : text.length
288
- };
289
- } else {
290
- const {
291
- node: startNode,
292
- offset: startOffset
293
- } = (0, _resolveSelectionTarget.resolveSelectionTarget)({
294
- target,
295
- node,
296
- offset: start
297
- });
298
- const {
299
- node: endNode,
300
- offset: endOffset
301
- } = (0, _resolveSelectionTarget.resolveSelectionTarget)({
302
- target,
303
- node,
304
- offset: end
305
- });
306
- const range = new Range();
307
- range.setStart(startNode, startOffset);
308
- range.setEnd(endNode, endOffset);
309
- position.selectionRange = range;
310
- const selection = target.ownerDocument.getSelection();
311
- selection.removeAllRanges();
312
- selection.addRange(range.cloneRange());
313
- }
314
- }
315
- }
316
-
317
- function getTextRange(text, pos, clickCount) {
318
- if (clickCount % 3 === 1 || text.length === 0) {
319
- return [pos, pos];
320
- }
321
-
322
- const textPos = pos != null ? pos : text.length;
323
-
324
- if (clickCount % 3 === 2) {
325
- return [textPos - text.substr(0, pos).match(/(\w+|\s+|\W)?$/)[0].length, pos === undefined ? pos : pos + text.substr(pos).match(/^(\w+|\s+|\W)?/)[0].length];
326
- } // triple click
327
-
328
-
329
- return [textPos - text.substr(0, pos).match(/[^\r\n]*$/)[0].length, pos === undefined ? pos : pos + text.substr(pos).match(/^[^\r\n]*/)[0].length];
330
- }
@@ -1,5 +0,0 @@
1
- import { PointerTarget, SelectionTarget } from './types';
2
- export declare function resolveSelectionTarget({ target, node, offset, }: PointerTarget & SelectionTarget): {
3
- node: Node;
4
- offset: number;
5
- };
@@ -1,75 +0,0 @@
1
- "use strict";
2
-
3
- Object.defineProperty(exports, "__esModule", {
4
- value: true
5
- });
6
- exports.resolveSelectionTarget = resolveSelectionTarget;
7
-
8
- var _document = require("../document");
9
-
10
- var _utils = require("../utils");
11
-
12
- function resolveSelectionTarget({
13
- target,
14
- node,
15
- offset
16
- }) {
17
- if ((0, _utils.isElementType)(target, ['input', 'textarea'])) {
18
- return {
19
- node: target,
20
- offset: offset != null ? offset : (0, _document.getUIValue)(target).length
21
- };
22
- } else if (node) {
23
- return {
24
- node,
25
- offset: offset != null ? offset : node.nodeType === 3 ? node.nodeValue.length : node.childNodes.length
26
- };
27
- }
28
-
29
- return findNodeAtTextOffset(target, offset);
30
- }
31
-
32
- function findNodeAtTextOffset(node, offset, isRoot = true) {
33
- // When clicking after the content the browser behavior can be complicated:
34
- // 1. If there is textContent after the last element child,
35
- // the cursor is moved there.
36
- // 2. If there is textContent in the last element child,
37
- // the browser moves the cursor to the last non-empty text node inside this element.
38
- // 3. Otherwise the cursor is moved to the end of the target.
39
- let i = offset === undefined ? node.childNodes.length - 1 : 0;
40
- const step = offset === undefined ? -1 : +1;
41
-
42
- while (offset === undefined ? i >= (isRoot ? Math.max(node.childNodes.length - 1, 0) : 0) : i <= node.childNodes.length) {
43
- const c = node.childNodes.item(i);
44
- const text = String(c.textContent);
45
-
46
- if (text.length) {
47
- if (offset !== undefined && text.length < offset) {
48
- offset -= text.length;
49
- } else if (c.nodeType === 1) {
50
- return findNodeAtTextOffset(c, offset, false);
51
- } else {
52
- // The pre-commit hooks keeps changing this
53
- // See https://github.com/kentcdodds/kcd-scripts/issues/218
54
-
55
- /* istanbul ignore else */
56
- // eslint-disable-next-line no-lonely-if
57
- if (c.nodeType === 3) {
58
- var _offset;
59
-
60
- return {
61
- node: c,
62
- offset: (_offset = offset) != null ? _offset : c.nodeValue.length
63
- };
64
- }
65
- }
66
- }
67
-
68
- i += step;
69
- }
70
-
71
- return {
72
- node,
73
- offset: node.childNodes.length
74
- };
75
- }
@@ -1,72 +0,0 @@
1
- import { keyboardState } from '../keyboard/types';
2
- import { PointerCoords, MouseButton } from '../utils';
3
- /**
4
- * @internal Do not create/alter this by yourself as this type might be subject to changes.
5
- */
6
- export declare type pointerState = {
7
- /**
8
- All keys that have been pressed and not been lifted up yet.
9
- */
10
- pressed: {
11
- keyDef: pointerKey;
12
- pointerId: number;
13
- isMultiTouch: boolean;
14
- isPrimary: boolean;
15
- clickCount: number;
16
- unpreventedDefault: boolean;
17
- /** Target the key was pressed on */
18
- downTarget: Element;
19
- }[];
20
- activeClickCount?: [string, number];
21
- /**
22
- * Position of each pointer.
23
- * The mouse is always pointer 1 and keeps its position.
24
- * Pen and touch devices receive a new pointerId for every interaction.
25
- */
26
- position: Record<string, {
27
- pointerId: number;
28
- pointerType: 'mouse' | 'pen' | 'touch';
29
- } & Partial<PointerTarget> & {
30
- selectionRange?: Range | SelectionInputRange;
31
- }>;
32
- /**
33
- * Last applied pointer id
34
- */
35
- pointerId: number;
36
- };
37
- export declare type pointerOptions = {
38
- /** Delay between keystrokes */
39
- delay: number;
40
- /** Available pointer keys */
41
- pointerMap: pointerKey[];
42
- };
43
- export interface pointerKey {
44
- /** Name of the pointer key */
45
- name: string;
46
- /** Type of the pointer device */
47
- pointerType: 'mouse' | 'pen' | 'touch';
48
- /** Type of button */
49
- button?: MouseButton;
50
- }
51
- export interface PointerTarget {
52
- target: Element;
53
- coords?: PointerCoords;
54
- }
55
- export interface SelectionTarget {
56
- node?: Node;
57
- /**
58
- * If `node` is set, this is the DOM offset.
59
- * Otherwise this is the `textContent`/`value` offset on the `target`.
60
- */
61
- offset?: number;
62
- }
63
- /** Describes a selection inside `HTMLInputElement`/`HTMLTextareaElement` */
64
- export interface SelectionInputRange {
65
- node: HTMLInputElement | HTMLTextAreaElement;
66
- start: number;
67
- end: number;
68
- }
69
- export interface inputDeviceState {
70
- pointerState: pointerState;
71
- keyboardState: keyboardState;
72
- }
@@ -1 +0,0 @@
1
- "use strict";
@@ -1,4 +0,0 @@
1
- import { PointerOptions } from './utils';
2
- import type { UserEvent } from './setup';
3
- export declare function selectOptions(this: UserEvent, select: Element, values: HTMLElement | HTMLElement[] | string[] | string, init?: MouseEventInit, options?: PointerOptions): void;
4
- export declare function deselectOptions(this: UserEvent, select: Element, values: HTMLElement | HTMLElement[] | string[] | string, init?: MouseEventInit, options?: PointerOptions): void;
@@ -1,142 +0,0 @@
1
- "use strict";
2
-
3
- Object.defineProperty(exports, "__esModule", {
4
- value: true
5
- });
6
- exports.deselectOptions = deselectOptions;
7
- exports.selectOptions = selectOptions;
8
-
9
- var _dom = require("@testing-library/dom");
10
-
11
- var _utils = require("./utils");
12
-
13
- function selectOptions(select, values, init, options = {}) {
14
- return selectOptionsBase.call(this, true, select, values, init, options);
15
- }
16
-
17
- function deselectOptions(select, values, init, options = {}) {
18
- return selectOptionsBase.call(this, false, select, values, init, options);
19
- }
20
-
21
- function selectOptionsBase(newValue, select, values, init, {
22
- skipPointerEventsCheck
23
- }) {
24
- if (!newValue && !select.multiple) {
25
- throw (0, _dom.getConfig)().getElementError(`Unable to deselect an option in a non-multiple select. Use selectOptions to change the selection instead.`, select);
26
- }
27
-
28
- const valArray = Array.isArray(values) ? values : [values];
29
- const allOptions = Array.from(select.querySelectorAll('option, [role="option"]'));
30
- const selectedOptions = valArray.map(val => {
31
- if (typeof val !== 'string' && allOptions.includes(val)) {
32
- return val;
33
- } else {
34
- const matchingOption = allOptions.find(o => o.value === val || o.innerHTML === val);
35
-
36
- if (matchingOption) {
37
- return matchingOption;
38
- } else {
39
- throw (0, _dom.getConfig)().getElementError(`Value "${String(val)}" not found in options`, select);
40
- }
41
- }
42
- }).filter(option => !(0, _utils.isDisabled)(option));
43
- if ((0, _utils.isDisabled)(select) || !selectedOptions.length) return;
44
-
45
- if ((0, _utils.isElementType)(select, 'select')) {
46
- if (select.multiple) {
47
- for (const option of selectedOptions) {
48
- const withPointerEvents = skipPointerEventsCheck ? true : (0, _utils.hasPointerEvents)(option); // events fired for multiple select are weird. Can't use hover...
49
-
50
- if (withPointerEvents) {
51
- _dom.fireEvent.pointerOver(option, init);
52
-
53
- _dom.fireEvent.pointerEnter(select, init);
54
-
55
- _dom.fireEvent.mouseOver(option);
56
-
57
- _dom.fireEvent.mouseEnter(select);
58
-
59
- _dom.fireEvent.pointerMove(option, init);
60
-
61
- _dom.fireEvent.mouseMove(option, init);
62
-
63
- _dom.fireEvent.pointerDown(option, init);
64
-
65
- _dom.fireEvent.mouseDown(option, init);
66
- }
67
-
68
- (0, _utils.focus)(select);
69
-
70
- if (withPointerEvents) {
71
- _dom.fireEvent.pointerUp(option, init);
72
-
73
- _dom.fireEvent.mouseUp(option, init);
74
- }
75
-
76
- selectOption(option);
77
-
78
- if (withPointerEvents) {
79
- _dom.fireEvent.click(option, init);
80
- }
81
- }
82
- } else if (selectedOptions.length === 1) {
83
- const withPointerEvents = skipPointerEventsCheck ? true : (0, _utils.hasPointerEvents)(select); // the click to open the select options
84
-
85
- if (withPointerEvents) {
86
- this.click(select, init, {
87
- skipPointerEventsCheck: true
88
- });
89
- } else {
90
- (0, _utils.focus)(select);
91
- }
92
-
93
- selectOption(selectedOptions[0]);
94
-
95
- if (withPointerEvents) {
96
- // the browser triggers another click event on the select for the click on the option
97
- // this second click has no 'down' phase
98
- _dom.fireEvent.pointerOver(select, init);
99
-
100
- _dom.fireEvent.pointerEnter(select, init);
101
-
102
- _dom.fireEvent.mouseOver(select);
103
-
104
- _dom.fireEvent.mouseEnter(select);
105
-
106
- _dom.fireEvent.pointerUp(select, init);
107
-
108
- _dom.fireEvent.mouseUp(select, init);
109
-
110
- _dom.fireEvent.click(select, init);
111
- }
112
- } else {
113
- throw (0, _dom.getConfig)().getElementError(`Cannot select multiple options on a non-multiple select`, select);
114
- }
115
- } else if (select.getAttribute('role') === 'listbox') {
116
- selectedOptions.forEach(option => {
117
- this.hover(option, init, {
118
- skipPointerEventsCheck
119
- });
120
- this.click(option, init, {
121
- skipPointerEventsCheck
122
- });
123
- this.unhover(option, init, {
124
- skipPointerEventsCheck
125
- });
126
- });
127
- } else {
128
- throw (0, _dom.getConfig)().getElementError(`Cannot select options on elements that are neither select nor listbox elements`, select);
129
- }
130
-
131
- function selectOption(option) {
132
- option.selected = newValue;
133
- (0, _dom.fireEvent)(select, (0, _dom.createEvent)('input', select, {
134
- bubbles: true,
135
- cancelable: false,
136
- composed: true,
137
- ...init
138
- }));
139
-
140
- _dom.fireEvent.change(select, init);
141
- }
142
- }