@testing-library/user-event 14.0.0-alpha.11 → 14.0.0-alpha.15

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 (90) hide show
  1. package/dist/clipboard/copy.d.ts +2 -0
  2. package/dist/clipboard/copy.js +36 -0
  3. package/dist/clipboard/cut.d.ts +2 -0
  4. package/dist/clipboard/cut.js +42 -0
  5. package/dist/clipboard/index.d.ts +3 -0
  6. package/dist/clipboard/index.js +44 -0
  7. package/dist/clipboard/paste.d.ts +2 -0
  8. package/dist/clipboard/paste.js +47 -0
  9. package/dist/convenience/click.d.ts +4 -0
  10. package/dist/convenience/click.js +52 -0
  11. package/dist/convenience/hover.d.ts +3 -0
  12. package/dist/convenience/hover.js +31 -0
  13. package/dist/convenience/index.d.ts +3 -0
  14. package/dist/convenience/index.js +44 -0
  15. package/dist/convenience/tab.d.ts +4 -0
  16. package/dist/convenience/tab.js +12 -0
  17. package/dist/index.d.ts +2 -5
  18. package/dist/index.js +7 -8
  19. package/dist/keyboard/getNextKeyDef.d.ts +2 -3
  20. package/dist/keyboard/getNextKeyDef.js +6 -36
  21. package/dist/keyboard/index.d.ts +6 -17
  22. package/dist/keyboard/index.js +9 -43
  23. package/dist/keyboard/keyboardImplementation.d.ts +3 -3
  24. package/dist/keyboard/keyboardImplementation.js +47 -44
  25. package/dist/keyboard/plugins/character.js +16 -10
  26. package/dist/keyboard/plugins/combination.js +3 -1
  27. package/dist/keyboard/plugins/functional.js +38 -20
  28. package/dist/keyboard/types.d.ts +3 -12
  29. package/dist/options.d.ts +102 -0
  30. package/dist/options.js +36 -0
  31. package/dist/pointer/index.d.ts +6 -14
  32. package/dist/pointer/index.js +8 -42
  33. package/dist/pointer/parseKeyDef.d.ts +2 -2
  34. package/dist/pointer/parseKeyDef.js +1 -3
  35. package/dist/pointer/pointerAction.d.ts +3 -2
  36. package/dist/pointer/pointerAction.js +9 -15
  37. package/dist/pointer/pointerMove.d.ts +2 -1
  38. package/dist/pointer/pointerPress.d.ts +2 -1
  39. package/dist/pointer/types.d.ts +0 -11
  40. package/dist/setup/api.d.ts +5 -0
  41. package/dist/setup/api.js +111 -0
  42. package/dist/setup/config.d.ts +10 -0
  43. package/dist/setup/config.js +8 -0
  44. package/dist/setup/directApi.d.ts +21 -0
  45. package/dist/setup/directApi.js +95 -0
  46. package/dist/setup/index.d.ts +30 -0
  47. package/dist/setup/index.js +27 -0
  48. package/dist/setup/setup.d.ts +74 -0
  49. package/dist/setup/setup.js +98 -0
  50. package/dist/setup/wrapAsync.d.ts +4 -0
  51. package/dist/setup/wrapAsync.js +15 -0
  52. package/dist/{clear.d.ts → utility/clear.d.ts} +2 -2
  53. package/dist/{clear.js → utility/clear.js} +2 -5
  54. package/dist/utility/index.d.ts +4 -0
  55. package/dist/utility/index.js +57 -0
  56. package/dist/utility/selectOptions.d.ts +3 -0
  57. package/dist/{selectOptions.js → utility/selectOptions.js} +31 -41
  58. package/dist/utility/type.d.ts +9 -0
  59. package/dist/utility/type.js +37 -0
  60. package/dist/utility/upload.d.ts +5 -0
  61. package/dist/{upload.js → utility/upload.js} +6 -6
  62. package/dist/utils/dataTransfer/Blob.d.ts +1 -0
  63. package/dist/utils/dataTransfer/Blob.js +21 -0
  64. package/dist/utils/dataTransfer/Clipboard.d.ts +9 -0
  65. package/dist/utils/dataTransfer/Clipboard.js +188 -0
  66. package/dist/utils/dataTransfer/DataTransfer.d.ts +2 -0
  67. package/dist/utils/dataTransfer/DataTransfer.js +158 -0
  68. package/dist/utils/dataTransfer/FileList.d.ts +1 -0
  69. package/dist/utils/dataTransfer/FileList.js +13 -0
  70. package/dist/utils/focus/copySelection.d.ts +1 -0
  71. package/dist/utils/focus/copySelection.js +36 -0
  72. package/dist/utils/index.d.ts +6 -0
  73. package/dist/utils/index.js +78 -0
  74. package/dist/utils/misc/getDocumentFromNode.d.ts +1 -0
  75. package/dist/utils/misc/getDocumentFromNode.js +14 -0
  76. package/package.json +1 -1
  77. package/dist/click.d.ts +0 -9
  78. package/dist/click.js +0 -62
  79. package/dist/hover.d.ts +0 -4
  80. package/dist/hover.js +0 -43
  81. package/dist/paste.d.ts +0 -7
  82. package/dist/paste.js +0 -60
  83. package/dist/selectOptions.d.ts +0 -4
  84. package/dist/setup.d.ts +0 -92
  85. package/dist/setup.js +0 -203
  86. package/dist/tab.d.ts +0 -5
  87. package/dist/tab.js +0 -12
  88. package/dist/type.d.ts +0 -14
  89. package/dist/type.js +0 -74
  90. package/dist/upload.d.ts +0 -10
package/dist/setup.js DELETED
@@ -1,203 +0,0 @@
1
- "use strict";
2
-
3
- Object.defineProperty(exports, "__esModule", {
4
- value: true
5
- });
6
- exports.setup = setup;
7
- exports.userEventApis = void 0;
8
-
9
- var _clear = require("./clear");
10
-
11
- var _click = require("./click");
12
-
13
- var _document = require("./document");
14
-
15
- var _hover = require("./hover");
16
-
17
- var _keyboard = require("./keyboard");
18
-
19
- var _paste = require("./paste");
20
-
21
- var _pointer = require("./pointer");
22
-
23
- var _selectOptions = require("./selectOptions");
24
-
25
- var _tab = require("./tab");
26
-
27
- var _type = require("./type");
28
-
29
- var _upload = require("./upload");
30
-
31
- const userEventApis = {
32
- clear: _clear.clear,
33
- click: _click.click,
34
- dblClick: _click.dblClick,
35
- deselectOptions: _selectOptions.deselectOptions,
36
- hover: _hover.hover,
37
- keyboard: _keyboard.keyboard,
38
- paste: _paste.paste,
39
- pointer: _pointer.pointer,
40
- selectOptions: _selectOptions.selectOptions,
41
- tab: _tab.tab,
42
- tripleClick: _click.tripleClick,
43
- type: _type.type,
44
- unhover: _hover.unhover,
45
- upload: _upload.upload
46
- };
47
- exports.userEventApis = userEventApis;
48
-
49
- /**
50
- * Start a "session" with userEvent.
51
- * All APIs returned by this function share an input device state and a default configuration.
52
- */
53
- function setup(options = {}) {
54
- var _options$document;
55
-
56
- (0, _document.prepareDocument)((_options$document = options.document) != null ? _options$document : document);
57
- return _setup(options, {
58
- keyboardState: (0, _keyboard.createKeyboardState)(),
59
- pointerState: (0, _pointer.createPointerState)()
60
- });
61
- }
62
-
63
- function _setup({
64
- applyAccept,
65
- autoModify,
66
- delay = 0,
67
- document,
68
- keyboardMap,
69
- pointerMap,
70
- skipAutoClose,
71
- skipClick,
72
- skipHover,
73
- skipPointerEventsCheck = false
74
- }, {
75
- keyboardState,
76
- pointerState
77
- }) {
78
- const keyboardDefaults = {
79
- autoModify,
80
- delay,
81
- document,
82
- keyboardMap
83
- };
84
- const pointerDefaults = {
85
- skipPointerEventsCheck
86
- };
87
- const pointerApiDefaults = {
88
- delay,
89
- pointerMap
90
- };
91
- const clickDefaults = {
92
- skipHover
93
- };
94
- const typeDefaults = {
95
- delay,
96
- skipAutoClose,
97
- skipClick
98
- };
99
- const uploadDefaults = {
100
- applyAccept
101
- };
102
- const userEvent = {
103
- clear: (...args) => {
104
- return _clear.clear.call(userEvent, ...args);
105
- },
106
- click: (...args) => {
107
- args[2] = { ...pointerDefaults,
108
- ...clickDefaults,
109
- ...args[2]
110
- };
111
- return _click.click.call(userEvent, ...args);
112
- },
113
- dblClick: (...args) => {
114
- args[2] = { ...pointerDefaults,
115
- ...clickDefaults,
116
- ...args[2]
117
- };
118
- return _click.dblClick.call(userEvent, ...args);
119
- },
120
- deselectOptions: (...args) => {
121
- args[3] = { ...pointerDefaults,
122
- ...args[3]
123
- };
124
- return _selectOptions.deselectOptions.call(userEvent, ...args);
125
- },
126
- hover: (...args) => {
127
- args[2] = { ...pointerDefaults,
128
- ...args[2]
129
- };
130
- return _hover.hover.call(userEvent, ...args);
131
- },
132
- // keyboard needs typecasting because of the overloading
133
- keyboard: (...args) => {
134
- args[1] = { ...keyboardDefaults,
135
- ...args[1],
136
- keyboardState
137
- };
138
- const ret = (0, _keyboard.keyboard)(...args);
139
-
140
- if (ret instanceof Promise) {
141
- return ret.then(() => undefined);
142
- }
143
- },
144
- paste: (...args) => {
145
- return _paste.paste.call(userEvent, ...args);
146
- },
147
- // pointer needs typecasting because of the overloading
148
- pointer: (...args) => {
149
- args[1] = { ...pointerApiDefaults,
150
- ...args[1],
151
- pointerState,
152
- keyboardState
153
- };
154
- const ret = (0, _pointer.pointer)(...args);
155
-
156
- if (ret instanceof Promise) {
157
- return ret.then(() => undefined);
158
- }
159
- },
160
- selectOptions: (...args) => {
161
- args[3] = { ...pointerDefaults,
162
- ...args[3]
163
- };
164
- return _selectOptions.selectOptions.call(userEvent, ...args);
165
- },
166
- setup: options => {
167
- return _setup({ ...keyboardDefaults,
168
- ...pointerDefaults,
169
- ...clickDefaults,
170
- ...options
171
- }, {
172
- keyboardState,
173
- pointerState
174
- });
175
- },
176
- tab: (...args) => {
177
- return _tab.tab.call(userEvent, ...args);
178
- },
179
- tripleClick: (...args) => {
180
- return _click.tripleClick.call(userEvent, ...args);
181
- },
182
- // type needs typecasting because of the overloading
183
- type: (...args) => {
184
- args[2] = { ...typeDefaults,
185
- ...args[2]
186
- };
187
- return _type.type.call(userEvent, ...args);
188
- },
189
- unhover: (...args) => {
190
- args[2] = { ...pointerDefaults,
191
- ...args[2]
192
- };
193
- return _hover.unhover.call(userEvent, ...args);
194
- },
195
- upload: (...args) => {
196
- args[3] = { ...uploadDefaults,
197
- ...args[3]
198
- };
199
- return _upload.upload.call(userEvent, ...args);
200
- }
201
- };
202
- return userEvent;
203
- }
package/dist/tab.d.ts DELETED
@@ -1,5 +0,0 @@
1
- import type { UserEvent } from './setup';
2
- export interface tabOptions {
3
- shift?: boolean;
4
- }
5
- export declare function tab(this: UserEvent, { shift }?: tabOptions): void;
package/dist/tab.js DELETED
@@ -1,12 +0,0 @@
1
- "use strict";
2
-
3
- Object.defineProperty(exports, "__esModule", {
4
- value: true
5
- });
6
- exports.tab = tab;
7
-
8
- function tab({
9
- shift
10
- } = {}) {
11
- this.keyboard(shift === true ? '{Shift>}{Tab}{/Shift}' : shift === false ? '[/ShiftLeft][/ShiftRight]{Tab}' : '{Tab}');
12
- }
package/dist/type.d.ts DELETED
@@ -1,14 +0,0 @@
1
- import type { UserEvent } from './setup';
2
- export interface typeOptions {
3
- delay?: number;
4
- skipClick?: boolean;
5
- skipAutoClose?: boolean;
6
- initialSelectionStart?: number;
7
- initialSelectionEnd?: number;
8
- }
9
- export declare function type(this: UserEvent, element: Element, text: string, options?: typeOptions & {
10
- delay?: 0;
11
- }): void;
12
- export declare function type(this: UserEvent, element: Element, text: string, options: typeOptions & {
13
- delay: number;
14
- }): Promise<void>;
package/dist/type.js DELETED
@@ -1,74 +0,0 @@
1
- "use strict";
2
-
3
- Object.defineProperty(exports, "__esModule", {
4
- value: true
5
- });
6
- exports.type = type;
7
-
8
- var _dom = require("@testing-library/dom");
9
-
10
- var _document = require("./document");
11
-
12
- var _utils = require("./utils");
13
-
14
- var _keyboard = require("./keyboard");
15
-
16
- // this needs to be wrapped in the event/asyncWrapper for React's act and angular's change detection
17
- // depending on whether it will be async.
18
- function type(element, text, {
19
- delay = 0,
20
- ...options
21
- } = {}) {
22
- (0, _document.prepareDocument)(element.ownerDocument); // we do not want to wrap in the asyncWrapper if we're not
23
- // going to actually be doing anything async, so we only wrap
24
- // if the delay is greater than 0
25
-
26
- if (delay > 0) {
27
- return (0, _dom.getConfig)().asyncWrapper(() => typeImplementation(this, element, text, {
28
- delay,
29
- ...options
30
- }));
31
- } else {
32
- return void typeImplementation(this, element, text, {
33
- delay,
34
- ...options
35
- }) // prevents users from dealing with UnhandledPromiseRejectionWarning
36
- .catch(console.error);
37
- }
38
- }
39
-
40
- async function typeImplementation(userEvent, element, text, {
41
- delay,
42
- skipClick = false,
43
- skipAutoClose = false,
44
- initialSelectionStart = undefined,
45
- initialSelectionEnd = undefined
46
- }) {
47
- // TODO: properly type guard
48
- // we use this workaround for now to prevent changing behavior
49
- if (element.disabled) return;
50
- if (!skipClick) userEvent.click(element);
51
-
52
- if (initialSelectionStart !== undefined) {
53
- (0, _utils.setSelectionRange)(element, initialSelectionStart, initialSelectionEnd != null ? initialSelectionEnd : initialSelectionStart);
54
- }
55
-
56
- const {
57
- promise,
58
- releaseAllKeys
59
- } = (0, _keyboard.keyboardImplementationWrapper)(text, {
60
- delay,
61
- document: element.ownerDocument
62
- });
63
-
64
- if (delay > 0) {
65
- await promise;
66
- }
67
-
68
- if (!skipAutoClose) {
69
- releaseAllKeys();
70
- } // eslint-disable-next-line consistent-return -- we need to return the internal Promise so that it is catchable if we don't await
71
-
72
-
73
- return promise;
74
- }
package/dist/upload.d.ts DELETED
@@ -1,10 +0,0 @@
1
- import type { UserEvent } from './setup';
2
- interface uploadInit {
3
- clickInit?: MouseEventInit;
4
- changeInit?: EventInit;
5
- }
6
- export interface uploadOptions {
7
- applyAccept?: boolean;
8
- }
9
- export declare function upload(this: UserEvent, element: HTMLElement, fileOrFiles: File | File[], init?: uploadInit, { applyAccept }?: uploadOptions): void;
10
- export {};