@testing-library/user-event 14.4.2 → 14.4.3

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 (209) hide show
  1. package/dist/cjs/clipboard/copy.js +4 -14
  2. package/dist/cjs/clipboard/cut.js +4 -14
  3. package/dist/cjs/clipboard/paste.js +2 -12
  4. package/dist/cjs/convenience/click.js +1 -4
  5. package/dist/cjs/convenience/hover.js +2 -12
  6. package/dist/cjs/document/{selection.js → UI.js} +43 -57
  7. package/dist/cjs/document/copySelection.js +37 -0
  8. package/dist/cjs/document/getValueOrTextContent.js +27 -0
  9. package/dist/cjs/document/index.js +13 -68
  10. package/dist/cjs/document/interceptor.js +83 -0
  11. package/dist/cjs/document/prepareDocument.js +67 -0
  12. package/dist/cjs/document/trackValue.js +65 -0
  13. package/dist/cjs/event/behavior/click.js +8 -12
  14. package/dist/cjs/event/behavior/cut.js +5 -11
  15. package/dist/cjs/event/behavior/keydown.js +39 -43
  16. package/dist/cjs/event/behavior/keypress.js +8 -9
  17. package/dist/cjs/event/behavior/keyup.js +5 -7
  18. package/dist/cjs/event/behavior/paste.js +5 -11
  19. package/dist/cjs/event/createEvent.js +2 -9
  20. package/dist/cjs/event/dispatchEvent.js +20 -2
  21. package/dist/cjs/event/focus.js +44 -0
  22. package/dist/cjs/event/index.js +24 -17
  23. package/dist/cjs/{utils/edit → event}/input.js +48 -46
  24. package/dist/cjs/{utils/edit/walkRadio.js → event/radio.js} +13 -7
  25. package/dist/cjs/event/selection/getInputRange.js +20 -0
  26. package/dist/cjs/event/selection/getTargetTypeAndSelection.js +40 -0
  27. package/dist/cjs/event/selection/index.js +26 -0
  28. package/dist/cjs/event/selection/modifySelection.js +30 -0
  29. package/dist/cjs/event/selection/modifySelectionPerMouse.js +49 -0
  30. package/dist/cjs/event/selection/moveSelection.js +47 -0
  31. package/dist/cjs/{utils/focus → event/selection}/resolveCaretPosition.js +9 -17
  32. package/dist/cjs/event/selection/selectAll.js +47 -0
  33. package/dist/cjs/event/selection/setSelection.js +30 -0
  34. package/dist/cjs/event/selection/setSelectionPerMouse.js +90 -0
  35. package/dist/cjs/event/selection/setSelectionRange.js +40 -0
  36. package/dist/cjs/event/selection/updateSelectionOnFocus.js +45 -0
  37. package/dist/cjs/keyboard/index.js +13 -23
  38. package/dist/cjs/keyboard/parseKeyDef.js +1 -9
  39. package/dist/cjs/options.js +0 -28
  40. package/dist/cjs/pointer/index.js +20 -30
  41. package/dist/cjs/pointer/parseKeyDef.js +1 -9
  42. package/dist/cjs/setup/directApi.js +6 -6
  43. package/dist/cjs/setup/index.js +0 -2
  44. package/dist/cjs/setup/setup.js +65 -37
  45. package/dist/cjs/system/keyboard.js +7 -9
  46. package/dist/cjs/system/pointer/index.js +16 -21
  47. package/dist/cjs/system/pointer/mouse.js +45 -38
  48. package/dist/cjs/system/pointer/pointer.js +33 -35
  49. package/dist/cjs/system/pointer/shared.js +10 -0
  50. package/dist/cjs/utility/clear.js +10 -11
  51. package/dist/cjs/utility/selectOptions.js +17 -19
  52. package/dist/cjs/utility/type.js +6 -15
  53. package/dist/cjs/utility/upload.js +3 -13
  54. package/dist/cjs/utils/dataTransfer/Clipboard.js +1 -15
  55. package/dist/cjs/utils/edit/isEditable.js +6 -10
  56. package/dist/cjs/utils/edit/maxLength.js +4 -15
  57. package/dist/cjs/utils/edit/{buildTimeValue.js → timeValue.js} +6 -0
  58. package/dist/cjs/utils/focus/cursor.js +0 -16
  59. package/dist/cjs/utils/focus/selection.js +1 -271
  60. package/dist/cjs/utils/index.js +7 -32
  61. package/dist/cjs/utils/misc/level.js +4 -9
  62. package/dist/cjs/utils/pointer/cssPointerEvents.js +9 -22
  63. package/dist/esm/clipboard/copy.js +4 -14
  64. package/dist/esm/clipboard/cut.js +4 -14
  65. package/dist/esm/clipboard/paste.js +2 -12
  66. package/dist/esm/convenience/click.js +1 -4
  67. package/dist/esm/convenience/hover.js +2 -12
  68. package/dist/esm/document/{selection.js → UI.js} +35 -56
  69. package/dist/esm/document/copySelection.js +33 -0
  70. package/dist/esm/document/getValueOrTextContent.js +23 -0
  71. package/dist/esm/document/index.js +4 -66
  72. package/dist/esm/document/interceptor.js +81 -1
  73. package/dist/esm/document/prepareDocument.js +63 -0
  74. package/dist/esm/document/{value.js → trackValue.js} +3 -61
  75. package/dist/esm/event/behavior/click.js +8 -12
  76. package/dist/esm/event/behavior/cut.js +5 -11
  77. package/dist/esm/event/behavior/keydown.js +32 -36
  78. package/dist/esm/event/behavior/keypress.js +8 -9
  79. package/dist/esm/event/behavior/keyup.js +5 -7
  80. package/dist/esm/event/behavior/paste.js +5 -11
  81. package/dist/esm/event/createEvent.js +2 -9
  82. package/dist/esm/event/dispatchEvent.js +19 -3
  83. package/dist/esm/event/focus.js +39 -0
  84. package/dist/esm/event/index.js +14 -19
  85. package/dist/esm/{utils/edit → event}/input.js +35 -33
  86. package/dist/esm/{utils/edit/walkRadio.js → event/radio.js} +13 -7
  87. package/dist/esm/event/selection/getInputRange.js +16 -0
  88. package/dist/esm/event/selection/getTargetTypeAndSelection.js +36 -0
  89. package/dist/esm/event/selection/index.js +9 -0
  90. package/dist/esm/event/selection/modifySelection.js +26 -0
  91. package/dist/esm/event/selection/modifySelectionPerMouse.js +45 -0
  92. package/dist/esm/event/selection/moveSelection.js +43 -0
  93. package/dist/esm/{utils/focus → event/selection}/resolveCaretPosition.js +8 -16
  94. package/dist/esm/{utils/focus → event/selection}/selectAll.js +12 -21
  95. package/dist/esm/event/selection/setSelection.js +26 -0
  96. package/dist/esm/event/selection/setSelectionPerMouse.js +86 -0
  97. package/dist/esm/event/selection/setSelectionRange.js +36 -0
  98. package/dist/esm/event/selection/updateSelectionOnFocus.js +41 -0
  99. package/dist/esm/keyboard/index.js +13 -23
  100. package/dist/esm/keyboard/parseKeyDef.js +1 -9
  101. package/dist/esm/options.js +1 -26
  102. package/dist/esm/pointer/index.js +20 -30
  103. package/dist/esm/pointer/parseKeyDef.js +1 -9
  104. package/dist/esm/setup/directApi.js +6 -6
  105. package/dist/esm/setup/index.js +0 -1
  106. package/dist/esm/setup/setup.js +59 -32
  107. package/dist/esm/system/keyboard.js +7 -9
  108. package/dist/esm/system/pointer/index.js +17 -21
  109. package/dist/esm/system/pointer/mouse.js +42 -35
  110. package/dist/esm/system/pointer/pointer.js +32 -34
  111. package/dist/esm/system/pointer/shared.js +6 -0
  112. package/dist/esm/utility/clear.js +10 -11
  113. package/dist/esm/utility/selectOptions.js +17 -19
  114. package/dist/esm/utility/type.js +5 -14
  115. package/dist/esm/utility/upload.js +3 -13
  116. package/dist/esm/utils/dataTransfer/Clipboard.js +1 -15
  117. package/dist/esm/utils/edit/isEditable.js +4 -8
  118. package/dist/esm/utils/edit/maxLength.js +3 -15
  119. package/dist/esm/utils/edit/{buildTimeValue.js → timeValue.js} +6 -1
  120. package/dist/esm/utils/focus/cursor.js +0 -16
  121. package/dist/esm/utils/focus/selection.js +3 -265
  122. package/dist/esm/utils/index.js +4 -11
  123. package/dist/esm/utils/misc/level.js +4 -9
  124. package/dist/esm/utils/pointer/cssPointerEvents.js +9 -22
  125. package/dist/types/clipboard/copy.d.ts +1 -1
  126. package/dist/types/clipboard/cut.d.ts +1 -1
  127. package/dist/types/clipboard/paste.d.ts +1 -1
  128. package/dist/types/convenience/click.d.ts +1 -1
  129. package/dist/types/convenience/hover.d.ts +1 -1
  130. package/dist/types/document/UI.d.ts +42 -0
  131. package/dist/types/{utils/focus → document}/copySelection.d.ts +0 -0
  132. package/dist/types/document/getValueOrTextContent.d.ts +1 -0
  133. package/dist/types/document/index.d.ts +5 -10
  134. package/dist/types/document/interceptor.d.ts +3 -0
  135. package/dist/types/document/prepareDocument.d.ts +8 -0
  136. package/dist/types/document/trackValue.d.ts +17 -0
  137. package/dist/types/event/behavior/registry.d.ts +2 -2
  138. package/dist/types/event/dispatchEvent.d.ts +5 -2
  139. package/dist/types/event/focus.d.ts +5 -0
  140. package/dist/types/event/index.d.ts +6 -4
  141. package/dist/types/event/input.d.ts +2 -0
  142. package/dist/types/event/radio.d.ts +4 -0
  143. package/dist/types/event/selection/getInputRange.d.ts +5 -0
  144. package/dist/types/event/selection/getTargetTypeAndSelection.d.ts +10 -0
  145. package/dist/types/event/selection/index.d.ts +15 -0
  146. package/dist/types/event/selection/modifySelection.d.ts +8 -0
  147. package/dist/types/event/selection/modifySelectionPerMouse.d.ts +7 -0
  148. package/dist/types/event/selection/moveSelection.d.ts +4 -0
  149. package/dist/types/{utils/focus → event/selection}/resolveCaretPosition.d.ts +0 -0
  150. package/dist/types/{utils/focus → event/selection}/selectAll.d.ts +0 -0
  151. package/dist/types/event/selection/setSelection.d.ts +10 -0
  152. package/dist/types/event/selection/setSelectionPerMouse.d.ts +8 -0
  153. package/dist/types/event/selection/setSelectionRange.d.ts +6 -0
  154. package/dist/types/event/selection/updateSelectionOnFocus.d.ts +5 -0
  155. package/dist/types/keyboard/index.d.ts +2 -2
  156. package/dist/types/options.d.ts +0 -8
  157. package/dist/types/pointer/index.d.ts +3 -3
  158. package/dist/types/setup/directApi.d.ts +1 -1
  159. package/dist/types/setup/index.d.ts +2 -15
  160. package/dist/types/setup/setup.d.ts +25 -7
  161. package/dist/types/system/keyboard.d.ts +3 -3
  162. package/dist/types/system/pointer/buttons.d.ts +1 -1
  163. package/dist/types/system/pointer/index.d.ts +7 -25
  164. package/dist/types/system/pointer/mouse.d.ts +5 -5
  165. package/dist/types/system/pointer/pointer.d.ts +7 -7
  166. package/dist/types/system/pointer/shared.d.ts +20 -0
  167. package/dist/types/utility/clear.d.ts +1 -1
  168. package/dist/types/utility/selectOptions.d.ts +1 -1
  169. package/dist/types/utility/type.d.ts +3 -3
  170. package/dist/types/utility/upload.d.ts +1 -1
  171. package/dist/types/utils/click/isClickableInput.d.ts +2 -2
  172. package/dist/types/utils/edit/isEditable.d.ts +5 -6
  173. package/dist/types/utils/edit/maxLength.d.ts +14 -1
  174. package/dist/types/utils/edit/{isValidDateOrTimeValue.d.ts → timeValue.d.ts} +1 -0
  175. package/dist/types/utils/focus/selection.d.ts +4 -69
  176. package/dist/types/utils/index.d.ts +2 -9
  177. package/dist/types/utils/misc/level.d.ts +4 -13
  178. package/dist/types/utils/misc/wait.d.ts +2 -2
  179. package/dist/types/utils/pointer/cssPointerEvents.d.ts +4 -4
  180. package/package.json +3 -2
  181. package/dist/cjs/document/setRangeText.js +0 -21
  182. package/dist/cjs/document/value.js +0 -127
  183. package/dist/cjs/setup/config.js +0 -7
  184. package/dist/cjs/utils/edit/getValue.js +0 -35
  185. package/dist/cjs/utils/edit/isValidDateOrTimeValue.js +0 -11
  186. package/dist/cjs/utils/focus/blur.js +0 -16
  187. package/dist/cjs/utils/focus/copySelection.js +0 -46
  188. package/dist/cjs/utils/focus/focus.js +0 -29
  189. package/dist/cjs/utils/focus/selectAll.js +0 -56
  190. package/dist/cjs/utils/misc/eventWrapper.js +0 -15
  191. package/dist/esm/document/setRangeText.js +0 -17
  192. package/dist/esm/setup/config.js +0 -3
  193. package/dist/esm/utils/edit/getValue.js +0 -31
  194. package/dist/esm/utils/edit/isValidDateOrTimeValue.js +0 -7
  195. package/dist/esm/utils/focus/blur.js +0 -12
  196. package/dist/esm/utils/focus/copySelection.js +0 -42
  197. package/dist/esm/utils/focus/focus.js +0 -25
  198. package/dist/esm/utils/misc/eventWrapper.js +0 -11
  199. package/dist/types/document/selection.d.ts +0 -29
  200. package/dist/types/document/setRangeText.d.ts +0 -1
  201. package/dist/types/document/value.d.ts +0 -26
  202. package/dist/types/setup/config.d.ts +0 -6
  203. package/dist/types/utils/edit/buildTimeValue.d.ts +0 -1
  204. package/dist/types/utils/edit/getValue.d.ts +0 -1
  205. package/dist/types/utils/edit/input.d.ts +0 -2
  206. package/dist/types/utils/edit/walkRadio.d.ts +0 -4
  207. package/dist/types/utils/focus/blur.d.ts +0 -2
  208. package/dist/types/utils/focus/focus.d.ts +0 -5
  209. package/dist/types/utils/misc/eventWrapper.d.ts +0 -1
@@ -1,31 +0,0 @@
1
- import '../click/isClickableInput.js';
2
- import '../dataTransfer/Clipboard.js';
3
- import './maxLength.js';
4
- import { isContentEditable } from './isContentEditable.js';
5
- import './isEditable.js';
6
- import '@testing-library/dom';
7
- import '@testing-library/dom/dist/helpers.js';
8
- import '../keyDef/readNextDescriptor.js';
9
- import '../misc/level.js';
10
- import '../../options.js';
11
- import '../../event/eventMap.js';
12
- import '../../event/behavior/click.js';
13
- import '../../event/behavior/cut.js';
14
- import '../../event/behavior/keydown.js';
15
- import '../../event/behavior/keypress.js';
16
- import '../../event/behavior/keyup.js';
17
- import '../../event/behavior/paste.js';
18
- import { getUIValue } from '../../document/value.js';
19
-
20
- function getValue(element) {
21
- // istanbul ignore if
22
- if (!element) {
23
- return null;
24
- }
25
- if (isContentEditable(element)) {
26
- return element.textContent;
27
- }
28
- return getUIValue(element);
29
- }
30
-
31
- export { getValue };
@@ -1,7 +0,0 @@
1
- function isValidDateOrTimeValue(element, value) {
2
- const clone = element.cloneNode();
3
- clone.value = value;
4
- return clone.value === value;
5
- }
6
-
7
- export { isValidDateOrTimeValue };
@@ -1,12 +0,0 @@
1
- import { eventWrapper } from '../misc/eventWrapper.js';
2
- import { getActiveElement } from './getActiveElement.js';
3
- import { isFocusable } from './isFocusable.js';
4
-
5
- function blur(element) {
6
- if (!isFocusable(element)) return;
7
- const wasActive = getActiveElement(element.ownerDocument) === element;
8
- if (!wasActive) return;
9
- eventWrapper(()=>element.blur());
10
- }
11
-
12
- export { blur };
@@ -1,42 +0,0 @@
1
- import '../click/isClickableInput.js';
2
- import { createDataTransfer } from '../dataTransfer/DataTransfer.js';
3
- import '../dataTransfer/Clipboard.js';
4
- import '../edit/maxLength.js';
5
- import '../edit/isEditable.js';
6
- import '@testing-library/dom';
7
- import { hasOwnSelection } from './selection.js';
8
- import { getWindow } from '../misc/getWindow.js';
9
- import '../keyDef/readNextDescriptor.js';
10
- import '../misc/level.js';
11
- import '../../options.js';
12
- import '../../event/eventMap.js';
13
- import '../../event/behavior/click.js';
14
- import '../../event/behavior/cut.js';
15
- import '../../event/behavior/keydown.js';
16
- import '../../event/behavior/keypress.js';
17
- import '../../event/behavior/keyup.js';
18
- import '../../event/behavior/paste.js';
19
- import { getUISelection } from '../../document/selection.js';
20
- import { getUIValue } from '../../document/value.js';
21
-
22
- function copySelection(target) {
23
- const data = hasOwnSelection(target) ? {
24
- 'text/plain': readSelectedValueFromInput(target)
25
- } : {
26
- 'text/plain': String(target.ownerDocument.getSelection())
27
- };
28
- const dt = createDataTransfer(getWindow(target));
29
- for(const type in data){
30
- if (data[type]) {
31
- dt.setData(type, data[type]);
32
- }
33
- }
34
- return dt;
35
- }
36
- function readSelectedValueFromInput(target) {
37
- const sel = getUISelection(target);
38
- const val = getUIValue(target);
39
- return val.substring(sel.startOffset, sel.endOffset);
40
- }
41
-
42
- export { copySelection };
@@ -1,25 +0,0 @@
1
- import { eventWrapper } from '../misc/eventWrapper.js';
2
- import { findClosest } from '../misc/findClosest.js';
3
- import { getActiveElement } from './getActiveElement.js';
4
- import { isFocusable } from './isFocusable.js';
5
- import { updateSelectionOnFocus } from './selection.js';
6
-
7
- /**
8
- * Focus closest focusable element.
9
- */ function focus(element) {
10
- const target = findClosest(element, isFocusable);
11
- const activeElement = getActiveElement(element.ownerDocument);
12
- if ((target !== null && target !== void 0 ? target : element.ownerDocument.body) === activeElement) {
13
- return;
14
- } else if (target) {
15
- eventWrapper(()=>target.focus());
16
- } else {
17
- eventWrapper(()=>{
18
- var ref;
19
- return (ref = activeElement) === null || ref === void 0 ? void 0 : ref.blur();
20
- });
21
- }
22
- updateSelectionOnFocus(target !== null && target !== void 0 ? target : element.ownerDocument.body);
23
- }
24
-
25
- export { focus };
@@ -1,11 +0,0 @@
1
- import { getConfig } from '@testing-library/dom';
2
-
3
- function eventWrapper(cb) {
4
- let result;
5
- getConfig().eventWrapper(()=>{
6
- result = cb();
7
- });
8
- return result;
9
- }
10
-
11
- export { eventWrapper };
@@ -1,29 +0,0 @@
1
- declare const UISelection: unique symbol;
2
- export interface UISelectionRange {
3
- startOffset: number;
4
- endOffset: number;
5
- }
6
- export interface UISelection {
7
- anchorOffset: number;
8
- focusOffset: number;
9
- }
10
- declare global {
11
- interface Element {
12
- [UISelection]?: UISelection;
13
- }
14
- }
15
- export declare function prepareSelectionInterceptor(element: HTMLInputElement | HTMLTextAreaElement): void;
16
- export declare function setUISelection(element: HTMLInputElement | HTMLTextAreaElement, { focusOffset: focusOffsetParam, anchorOffset: anchorOffsetParam, }: {
17
- anchorOffset?: number;
18
- focusOffset: number;
19
- }, mode?: 'replace' | 'modify'): void;
20
- export declare function getUISelection(element: HTMLInputElement | HTMLTextAreaElement): {
21
- startOffset: number;
22
- endOffset: number;
23
- anchorOffset: number;
24
- focusOffset: number;
25
- };
26
- export declare function hasUISelection(element: HTMLInputElement | HTMLTextAreaElement): boolean;
27
- /** Flag the IDL selection as clean. This does not change the selection. */
28
- export declare function setUISelectionClean(element: HTMLInputElement | HTMLTextAreaElement): void;
29
- export {};
@@ -1 +0,0 @@
1
- export declare function prepareRangeTextInterceptor(element: HTMLInputElement | HTMLTextAreaElement): void;
@@ -1,26 +0,0 @@
1
- declare const UIValue: unique symbol;
2
- declare const InitialValue: unique symbol;
3
- declare const TrackChanges: unique symbol;
4
- declare global {
5
- interface Window {
6
- REACT_VERSION?: number;
7
- }
8
- interface Element {
9
- [UIValue]?: string;
10
- [InitialValue]?: string;
11
- [TrackChanges]?: {
12
- previousValue?: string;
13
- tracked?: string[];
14
- nextValue?: string;
15
- };
16
- }
17
- }
18
- export declare function prepareValueInterceptor(element: HTMLInputElement | HTMLTextAreaElement): void;
19
- export declare function setUIValue(element: HTMLInputElement | HTMLTextAreaElement, value: string): void;
20
- export declare function getUIValue(element: HTMLInputElement | HTMLTextAreaElement): string;
21
- /** Flag the IDL value as clean. This does not change the value.*/
22
- export declare function setUIValueClean(element: HTMLInputElement | HTMLTextAreaElement): void;
23
- export declare function clearInitialValue(element: HTMLInputElement | HTMLTextAreaElement): void;
24
- export declare function getInitialValue(element: HTMLInputElement | HTMLTextAreaElement): string | undefined;
25
- export declare function commitValueAfterInput(element: HTMLInputElement | HTMLTextAreaElement, cursorOffset: number): void;
26
- export {};
@@ -1,6 +0,0 @@
1
- import type { Options } from '../options';
2
- import { System } from '../system';
3
- export interface Config extends Required<Options> {
4
- system: System;
5
- }
6
- export declare const Config: unique symbol;
@@ -1 +0,0 @@
1
- export declare function buildTimeValue(value: string): string;
@@ -1 +0,0 @@
1
- export declare function getValue<T extends Element | null>(element: T): T extends HTMLInputElement | HTMLTextAreaElement ? string : string | null;
@@ -1,2 +0,0 @@
1
- import { Config } from '../../setup';
2
- export declare function input(config: Config, element: Element, data: string, inputType?: string): void;
@@ -1,4 +0,0 @@
1
- import { Config } from '../../setup';
2
- export declare function walkRadio(config: Config, el: HTMLInputElement & {
3
- type: 'radio';
4
- }, direction: -1 | 1): void;
@@ -1,2 +0,0 @@
1
- declare function blur(element: Element): void;
2
- export { blur };
@@ -1,5 +0,0 @@
1
- /**
2
- * Focus closest focusable element.
3
- */
4
- declare function focus(element: Element): void;
5
- export { focus };
@@ -1 +0,0 @@
1
- export declare function eventWrapper<T>(cb: () => T): T | undefined;