@testing-library/user-event 14.0.0-alpha.6 → 14.0.0-beta.1

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 (137) 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/document/index.d.ts +1 -0
  18. package/dist/document/selection.d.ts +17 -7
  19. package/dist/document/selection.js +33 -17
  20. package/dist/document/value.d.ts +1 -1
  21. package/dist/document/value.js +1 -1
  22. package/dist/index.d.ts +2 -7
  23. package/dist/index.js +3 -12
  24. package/dist/keyboard/getEventProps.d.ts +0 -2
  25. package/dist/keyboard/getEventProps.js +1 -7
  26. package/dist/keyboard/index.d.ts +6 -18
  27. package/dist/keyboard/index.js +9 -45
  28. package/dist/keyboard/keyMap.js +24 -48
  29. package/dist/keyboard/keyboardAction.d.ts +10 -0
  30. package/dist/keyboard/keyboardAction.js +156 -0
  31. package/dist/keyboard/{getNextKeyDef.d.ts → parseKeyDef.d.ts} +4 -6
  32. package/dist/keyboard/parseKeyDef.js +61 -0
  33. package/dist/keyboard/plugins/arrow.js +7 -12
  34. package/dist/keyboard/plugins/character.js +42 -54
  35. package/dist/keyboard/plugins/combination.d.ts +5 -0
  36. package/dist/keyboard/plugins/combination.js +19 -0
  37. package/dist/keyboard/plugins/control.js +4 -12
  38. package/dist/keyboard/plugins/functional.js +46 -33
  39. package/dist/keyboard/plugins/index.d.ts +0 -1
  40. package/dist/keyboard/plugins/index.js +4 -11
  41. package/dist/keyboard/types.d.ts +3 -19
  42. package/dist/options.d.ts +102 -0
  43. package/dist/options.js +36 -0
  44. package/dist/pointer/index.d.ts +6 -14
  45. package/dist/pointer/index.js +8 -42
  46. package/dist/pointer/parseKeyDef.d.ts +2 -2
  47. package/dist/pointer/parseKeyDef.js +1 -3
  48. package/dist/pointer/pointerAction.d.ts +3 -2
  49. package/dist/pointer/pointerAction.js +9 -15
  50. package/dist/pointer/pointerMove.d.ts +2 -1
  51. package/dist/pointer/pointerMove.js +28 -17
  52. package/dist/pointer/pointerPress.d.ts +2 -1
  53. package/dist/pointer/pointerPress.js +6 -4
  54. package/dist/pointer/resolveSelectionTarget.js +7 -6
  55. package/dist/pointer/types.d.ts +0 -11
  56. package/dist/setup/api.d.ts +5 -0
  57. package/dist/setup/api.js +111 -0
  58. package/dist/setup/config.d.ts +10 -0
  59. package/dist/setup/config.js +8 -0
  60. package/dist/setup/directApi.d.ts +20 -0
  61. package/dist/setup/directApi.js +95 -0
  62. package/dist/setup/index.d.ts +30 -0
  63. package/dist/setup/index.js +27 -0
  64. package/dist/setup/setup.d.ts +74 -0
  65. package/dist/setup/setup.js +98 -0
  66. package/dist/setup/wrapAsync.d.ts +4 -0
  67. package/dist/setup/wrapAsync.js +15 -0
  68. package/dist/{clear.d.ts → utility/clear.d.ts} +2 -2
  69. package/dist/utility/clear.js +30 -0
  70. package/dist/utility/index.d.ts +4 -0
  71. package/dist/utility/index.js +57 -0
  72. package/dist/utility/selectOptions.d.ts +3 -0
  73. package/dist/{selectOptions.js → utility/selectOptions.js} +31 -41
  74. package/dist/utility/type.d.ts +9 -0
  75. package/dist/utility/type.js +37 -0
  76. package/dist/utility/upload.d.ts +5 -0
  77. package/dist/{upload.js → utility/upload.js} +12 -40
  78. package/dist/utils/dataTransfer/Blob.d.ts +1 -0
  79. package/dist/utils/dataTransfer/Blob.js +21 -0
  80. package/dist/utils/dataTransfer/Clipboard.d.ts +9 -0
  81. package/dist/utils/dataTransfer/Clipboard.js +188 -0
  82. package/dist/utils/dataTransfer/DataTransfer.d.ts +2 -0
  83. package/dist/utils/dataTransfer/DataTransfer.js +158 -0
  84. package/dist/utils/dataTransfer/FileList.d.ts +1 -0
  85. package/dist/utils/dataTransfer/FileList.js +23 -0
  86. package/dist/utils/edit/calculateNewValue.d.ts +12 -5
  87. package/dist/utils/edit/calculateNewValue.js +19 -21
  88. package/dist/utils/edit/editInputElement.d.ts +16 -0
  89. package/dist/utils/edit/{fireInputEvent.js → editInputElement.js} +20 -26
  90. package/dist/utils/edit/isContentEditable.d.ts +4 -0
  91. package/dist/utils/edit/isContentEditable.js +14 -0
  92. package/dist/utils/edit/isEditable.d.ts +1 -0
  93. package/dist/utils/edit/prepareInput.d.ts +7 -0
  94. package/dist/utils/edit/prepareInput.js +77 -0
  95. package/dist/utils/edit/setFiles.d.ts +12 -0
  96. package/dist/utils/edit/setFiles.js +72 -0
  97. package/dist/utils/focus/copySelection.d.ts +1 -0
  98. package/dist/utils/focus/copySelection.js +36 -0
  99. package/dist/utils/focus/focus.js +3 -0
  100. package/dist/utils/focus/selectAll.d.ts +5 -0
  101. package/dist/utils/focus/selectAll.js +51 -0
  102. package/dist/utils/focus/selection.d.ts +42 -0
  103. package/dist/utils/focus/selection.js +190 -0
  104. package/dist/utils/index.d.ts +11 -4
  105. package/dist/utils/index.js +124 -33
  106. package/dist/utils/misc/getDocumentFromNode.d.ts +1 -0
  107. package/dist/utils/misc/getDocumentFromNode.js +14 -0
  108. package/dist/utils/pointer/firePointerEvents.d.ts +12 -1
  109. package/dist/utils/pointer/firePointerEvents.js +62 -5
  110. package/package.json +1 -1
  111. package/dist/clear.js +0 -46
  112. package/dist/click.d.ts +0 -9
  113. package/dist/click.js +0 -62
  114. package/dist/hover.d.ts +0 -4
  115. package/dist/hover.js +0 -43
  116. package/dist/keyboard/getNextKeyDef.js +0 -85
  117. package/dist/keyboard/keyboardImplementation.d.ts +0 -3
  118. package/dist/keyboard/keyboardImplementation.js +0 -169
  119. package/dist/keyboard/specialCharMap.d.ts +0 -22
  120. package/dist/keyboard/specialCharMap.js +0 -30
  121. package/dist/paste.d.ts +0 -7
  122. package/dist/paste.js +0 -67
  123. package/dist/selectOptions.d.ts +0 -4
  124. package/dist/setup.d.ts +0 -92
  125. package/dist/setup.js +0 -203
  126. package/dist/tab.d.ts +0 -5
  127. package/dist/tab.js +0 -12
  128. package/dist/type.d.ts +0 -14
  129. package/dist/type.js +0 -74
  130. package/dist/upload.d.ts +0 -10
  131. package/dist/utils/edit/cursorPosition.d.ts +0 -2
  132. package/dist/utils/edit/cursorPosition.js +0 -35
  133. package/dist/utils/edit/fireInputEvent.d.ts +0 -8
  134. package/dist/utils/edit/selectionRange.d.ts +0 -5
  135. package/dist/utils/edit/selectionRange.js +0 -64
  136. package/dist/utils/pointer/fakeEvent.d.ts +0 -20
  137. package/dist/utils/pointer/fakeEvent.js +0 -91
@@ -8,19 +8,19 @@ exports.selectOptions = selectOptions;
8
8
 
9
9
  var _dom = require("@testing-library/dom");
10
10
 
11
- var _utils = require("./utils");
11
+ var _utils = require("../utils");
12
12
 
13
- function selectOptions(select, values, init, options = {}) {
14
- return selectOptionsBase.call(this, true, select, values, init, options);
13
+ var _setup = require("../setup");
14
+
15
+ async function selectOptions(select, values) {
16
+ return selectOptionsBase.call(this, true, select, values);
15
17
  }
16
18
 
17
- function deselectOptions(select, values, init, options = {}) {
18
- return selectOptionsBase.call(this, false, select, values, init, options);
19
+ async function deselectOptions(select, values) {
20
+ return selectOptionsBase.call(this, false, select, values);
19
21
  }
20
22
 
21
- function selectOptionsBase(newValue, select, values, init, {
22
- skipPointerEventsCheck
23
- }) {
23
+ async function selectOptionsBase(newValue, select, values) {
24
24
  if (!newValue && !select.multiple) {
25
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
26
  }
@@ -45,47 +45,45 @@ function selectOptionsBase(newValue, select, values, init, {
45
45
  if ((0, _utils.isElementType)(select, 'select')) {
46
46
  if (select.multiple) {
47
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...
48
+ const withPointerEvents = this[_setup.Config].skipPointerEventsCheck ? true : (0, _utils.hasPointerEvents)(option); // events fired for multiple select are weird. Can't use hover...
49
49
 
50
50
  if (withPointerEvents) {
51
- _dom.fireEvent.pointerOver(option, init);
51
+ _dom.fireEvent.pointerOver(option);
52
52
 
53
- _dom.fireEvent.pointerEnter(select, init);
53
+ _dom.fireEvent.pointerEnter(select);
54
54
 
55
55
  _dom.fireEvent.mouseOver(option);
56
56
 
57
57
  _dom.fireEvent.mouseEnter(select);
58
58
 
59
- _dom.fireEvent.pointerMove(option, init);
59
+ _dom.fireEvent.pointerMove(option);
60
60
 
61
- _dom.fireEvent.mouseMove(option, init);
61
+ _dom.fireEvent.mouseMove(option);
62
62
 
63
- _dom.fireEvent.pointerDown(option, init);
63
+ _dom.fireEvent.pointerDown(option);
64
64
 
65
- _dom.fireEvent.mouseDown(option, init);
65
+ _dom.fireEvent.mouseDown(option);
66
66
  }
67
67
 
68
68
  (0, _utils.focus)(select);
69
69
 
70
70
  if (withPointerEvents) {
71
- _dom.fireEvent.pointerUp(option, init);
71
+ _dom.fireEvent.pointerUp(option);
72
72
 
73
- _dom.fireEvent.mouseUp(option, init);
73
+ _dom.fireEvent.mouseUp(option);
74
74
  }
75
75
 
76
76
  selectOption(option);
77
77
 
78
78
  if (withPointerEvents) {
79
- _dom.fireEvent.click(option, init);
79
+ _dom.fireEvent.click(option);
80
80
  }
81
81
  }
82
82
  } else if (selectedOptions.length === 1) {
83
- const withPointerEvents = skipPointerEventsCheck ? true : (0, _utils.hasPointerEvents)(select); // the click to open the select options
83
+ const withPointerEvents = this[_setup.Config].skipPointerEventsCheck ? true : (0, _utils.hasPointerEvents)(select); // the click to open the select options
84
84
 
85
85
  if (withPointerEvents) {
86
- this.click(select, init, {
87
- skipPointerEventsCheck: true
88
- });
86
+ await this.click(select);
89
87
  } else {
90
88
  (0, _utils.focus)(select);
91
89
  }
@@ -95,35 +93,28 @@ function selectOptionsBase(newValue, select, values, init, {
95
93
  if (withPointerEvents) {
96
94
  // the browser triggers another click event on the select for the click on the option
97
95
  // this second click has no 'down' phase
98
- _dom.fireEvent.pointerOver(select, init);
96
+ _dom.fireEvent.pointerOver(select);
99
97
 
100
- _dom.fireEvent.pointerEnter(select, init);
98
+ _dom.fireEvent.pointerEnter(select);
101
99
 
102
100
  _dom.fireEvent.mouseOver(select);
103
101
 
104
102
  _dom.fireEvent.mouseEnter(select);
105
103
 
106
- _dom.fireEvent.pointerUp(select, init);
104
+ _dom.fireEvent.pointerUp(select);
107
105
 
108
- _dom.fireEvent.mouseUp(select, init);
106
+ _dom.fireEvent.mouseUp(select);
109
107
 
110
- _dom.fireEvent.click(select, init);
108
+ _dom.fireEvent.click(select);
111
109
  }
112
110
  } else {
113
111
  throw (0, _dom.getConfig)().getElementError(`Cannot select multiple options on a non-multiple select`, select);
114
112
  }
115
113
  } 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
- });
114
+ for (const option of selectedOptions) {
115
+ await this.click(option);
116
+ await this.unhover(option);
117
+ }
127
118
  } else {
128
119
  throw (0, _dom.getConfig)().getElementError(`Cannot select options on elements that are neither select nor listbox elements`, select);
129
120
  }
@@ -133,10 +124,9 @@ function selectOptionsBase(newValue, select, values, init, {
133
124
  (0, _dom.fireEvent)(select, (0, _dom.createEvent)('input', select, {
134
125
  bubbles: true,
135
126
  cancelable: false,
136
- composed: true,
137
- ...init
127
+ composed: true
138
128
  }));
139
129
 
140
- _dom.fireEvent.change(select, init);
130
+ _dom.fireEvent.change(select);
141
131
  }
142
132
  }
@@ -0,0 +1,9 @@
1
+ import type { UserEvent } from '../setup';
2
+ import { Config } from '../setup/config';
3
+ export interface typeOptions {
4
+ skipClick?: Config['skipClick'];
5
+ skipAutoClose?: Config['skipClick'];
6
+ initialSelectionStart?: number;
7
+ initialSelectionEnd?: number;
8
+ }
9
+ export declare function type(this: UserEvent, element: Element, text: string, { skipClick, skipAutoClose, initialSelectionStart, initialSelectionEnd, }?: typeOptions): Promise<void>;
@@ -0,0 +1,37 @@
1
+ "use strict";
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ exports.type = type;
7
+
8
+ var _utils = require("../utils");
9
+
10
+ var _keyboard = require("../keyboard");
11
+
12
+ var _config = require("../setup/config");
13
+
14
+ async function type(element, text, {
15
+ skipClick = this[_config.Config].skipClick,
16
+ skipAutoClose = this[_config.Config].skipAutoClose,
17
+ initialSelectionStart,
18
+ initialSelectionEnd
19
+ } = {}) {
20
+ // TODO: properly type guard
21
+ // we use this workaround for now to prevent changing behavior
22
+ if (element.disabled) return;
23
+
24
+ if (!skipClick) {
25
+ await this.click(element);
26
+ }
27
+
28
+ if (initialSelectionStart !== undefined) {
29
+ (0, _utils.setSelectionRange)(element, initialSelectionStart, initialSelectionEnd != null ? initialSelectionEnd : initialSelectionStart);
30
+ }
31
+
32
+ await this.keyboard(text);
33
+
34
+ if (!skipAutoClose) {
35
+ await (0, _keyboard.releaseAllKeys)(this[_config.Config]);
36
+ }
37
+ }
@@ -0,0 +1,5 @@
1
+ import { UserEvent } from '../setup';
2
+ export interface uploadInit {
3
+ changeInit?: EventInit;
4
+ }
5
+ export declare function upload(this: UserEvent, element: HTMLElement, fileOrFiles: File | File[]): Promise<void>;
@@ -7,11 +7,11 @@ exports.upload = upload;
7
7
 
8
8
  var _dom = require("@testing-library/dom");
9
9
 
10
- var _utils = require("./utils");
10
+ var _utils = require("../utils");
11
11
 
12
- function upload(element, fileOrFiles, init, {
13
- applyAccept = false
14
- } = {}) {
12
+ var _setup = require("../setup");
13
+
14
+ async function upload(element, fileOrFiles) {
15
15
  var _input$files;
16
16
 
17
17
  const input = (0, _utils.isElementType)(element, 'label') ? element.control : element;
@@ -23,8 +23,8 @@ function upload(element, fileOrFiles, init, {
23
23
  }
24
24
 
25
25
  if ((0, _utils.isDisabled)(element)) return;
26
- this.click(element, init == null ? void 0 : init.clickInit);
27
- const files = (Array.isArray(fileOrFiles) ? fileOrFiles : [fileOrFiles]).filter(file => !applyAccept || isAcceptableFile(file, input.accept)).slice(0, input.multiple ? undefined : 1); // blur fires when the file selector pops up
26
+ await this.click(element);
27
+ const files = (Array.isArray(fileOrFiles) ? fileOrFiles : [fileOrFiles]).filter(file => !this[_setup.Config].applyAccept || isAcceptableFile(file, input.accept)).slice(0, input.multiple ? undefined : 1); // blur fires when the file selector pops up
28
28
 
29
29
  (0, _utils.blur)(element); // focus fires when they make their selection
30
30
 
@@ -36,41 +36,13 @@ function upload(element, fileOrFiles, init, {
36
36
  return f === ((_input$files2 = input.files) == null ? void 0 : _input$files2.item(i));
37
37
  })) {
38
38
  return;
39
- } // the event fired in the browser isn't actually an "input" or "change" event
40
- // but a new Event with a type set to "input" and "change"
41
- // Kinda odd...
42
-
43
-
44
- const inputFiles = { ...files,
45
- length: files.length,
46
- item: index => files[index],
47
-
48
- [Symbol.iterator]() {
49
- let i = 0;
50
- return {
51
- next: () => ({
52
- done: i >= files.length,
53
- value: files[i++]
54
- })
55
- };
56
- }
39
+ }
57
40
 
58
- };
59
- (0, _dom.fireEvent)(input, (0, _dom.createEvent)('input', input, {
60
- target: {
61
- files: inputFiles
62
- },
63
- bubbles: true,
64
- cancelable: false,
65
- composed: true
66
- }));
67
-
68
- _dom.fireEvent.change(input, {
69
- target: {
70
- files: inputFiles
71
- },
72
- ...(init == null ? void 0 : init.changeInit)
73
- });
41
+ (0, _utils.setFiles)(input, (0, _utils.createFileList)(files));
42
+
43
+ _dom.fireEvent.input(input);
44
+
45
+ _dom.fireEvent.change(input);
74
46
  }
75
47
 
76
48
  function isAcceptableFile(file, accept) {
@@ -0,0 +1 @@
1
+ export declare function readBlobText(blob: Blob): Promise<string>;
@@ -0,0 +1,21 @@
1
+ "use strict";
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ exports.readBlobText = readBlobText;
7
+
8
+ // jsdom does not implement Blob.text()
9
+ function readBlobText(blob) {
10
+ return new Promise((res, rej) => {
11
+ const fr = new FileReader();
12
+ fr.onerror = rej;
13
+ fr.onabort = rej;
14
+
15
+ fr.onload = () => {
16
+ res(String(fr.result));
17
+ };
18
+
19
+ fr.readAsText(blob);
20
+ });
21
+ }
@@ -0,0 +1,9 @@
1
+ export declare function createClipboardItem(...blobs: Array<Blob | string>): ClipboardItem;
2
+ export declare function attachClipboardStubToView(window: Window & typeof globalThis): {
3
+ resetClipboardStub: () => void;
4
+ detachClipboardStub: () => void;
5
+ };
6
+ export declare function resetClipboardStubOnView(window: Window & typeof globalThis): void;
7
+ export declare function detachClipboardStubFromView(window: Window & typeof globalThis): void;
8
+ export declare function readDataTransferFromClipboard(document: Document): Promise<DataTransfer>;
9
+ export declare function writeDataTransferToClipboard(document: Document, clipboardData: DataTransfer): Promise<void>;
@@ -0,0 +1,188 @@
1
+ "use strict";
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ exports.attachClipboardStubToView = attachClipboardStubToView;
7
+ exports.createClipboardItem = createClipboardItem;
8
+ exports.detachClipboardStubFromView = detachClipboardStubFromView;
9
+ exports.readDataTransferFromClipboard = readDataTransferFromClipboard;
10
+ exports.resetClipboardStubOnView = resetClipboardStubOnView;
11
+ exports.writeDataTransferToClipboard = writeDataTransferToClipboard;
12
+
13
+ var _ = require("..");
14
+
15
+ // Clipboard is not available in jsdom
16
+ class ClipboardItemStub {
17
+ constructor(data) {
18
+ this.data = void 0;
19
+ this.data = data;
20
+ }
21
+
22
+ get types() {
23
+ return Array.from(Object.keys(this.data));
24
+ }
25
+
26
+ async getType(type) {
27
+ const data = await this.data[type];
28
+
29
+ if (!data) {
30
+ throw new Error(`${type} is not one of the available MIME types on this item.`);
31
+ }
32
+
33
+ return data instanceof Blob ? data : new Blob([data], {
34
+ type
35
+ });
36
+ }
37
+
38
+ }
39
+
40
+ const ClipboardStubControl = Symbol('Manage ClipboardSub');
41
+
42
+ class ClipboardStub extends EventTarget {
43
+ constructor(...args) {
44
+ super(...args);
45
+ this.items = [];
46
+ this[ClipboardStubControl] = void 0;
47
+ }
48
+
49
+ async read() {
50
+ return Array.from(this.items);
51
+ }
52
+
53
+ async readText() {
54
+ let text = '';
55
+
56
+ for (const item of this.items) {
57
+ const type = item.types.includes('text/plain') ? 'text/plain' : item.types.find(t => t.startsWith('text/'));
58
+
59
+ if (type) {
60
+ text += await item.getType(type).then(b => (0, _.readBlobText)(b));
61
+ }
62
+ }
63
+
64
+ return text;
65
+ }
66
+
67
+ async write(data) {
68
+ this.items = data;
69
+ }
70
+
71
+ async writeText(text) {
72
+ this.items = [createClipboardItem(text)];
73
+ }
74
+
75
+ } // MDN lists string|Blob|Promise<Blob|string> as possible types in ClipboardItemData
76
+ // lib.dom.d.ts lists only Promise<Blob|string>
77
+ // https://developer.mozilla.org/en-US/docs/Web/API/ClipboardItem/ClipboardItem#syntax
78
+
79
+
80
+ function createClipboardItem(...blobs) {
81
+ // use real ClipboardItem if available
82
+ // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
83
+ const constructor = typeof ClipboardItem === 'undefined' ? ClipboardItemStub :
84
+ /* istanbul ignore next */
85
+ ClipboardItem;
86
+ return new constructor(Object.fromEntries(blobs.map(b => [typeof b === 'string' ? 'text/plain' : b.type, Promise.resolve(b)])));
87
+ }
88
+
89
+ function attachClipboardStubToView(window) {
90
+ if (window.navigator.clipboard instanceof ClipboardStub) {
91
+ return window.navigator.clipboard[ClipboardStubControl];
92
+ }
93
+
94
+ const realClipboard = Object.getOwnPropertyDescriptor(window.navigator, 'clipboard');
95
+ let stub = new ClipboardStub();
96
+ const control = {
97
+ resetClipboardStub: () => {
98
+ stub = new ClipboardStub();
99
+ stub[ClipboardStubControl] = control;
100
+ },
101
+ detachClipboardStub: () => {
102
+ /* istanbul ignore if */
103
+ if (realClipboard) {
104
+ Object.defineProperty(window.navigator, 'clipboard', realClipboard);
105
+ } else {
106
+ Object.defineProperty(window.navigator, 'clipboard', {
107
+ value: undefined,
108
+ configurable: true
109
+ });
110
+ }
111
+ }
112
+ };
113
+ stub[ClipboardStubControl] = control;
114
+ Object.defineProperty(window.navigator, 'clipboard', {
115
+ get: () => stub,
116
+ configurable: true
117
+ });
118
+ return stub[ClipboardStubControl];
119
+ }
120
+
121
+ function resetClipboardStubOnView(window) {
122
+ if (window.navigator.clipboard instanceof ClipboardStub) {
123
+ window.navigator.clipboard[ClipboardStubControl].resetClipboardStub();
124
+ }
125
+ }
126
+
127
+ function detachClipboardStubFromView(window) {
128
+ if (window.navigator.clipboard instanceof ClipboardStub) {
129
+ window.navigator.clipboard[ClipboardStubControl].detachClipboardStub();
130
+ }
131
+ }
132
+
133
+ async function readDataTransferFromClipboard(document) {
134
+ var _document$defaultView;
135
+
136
+ const clipboard = (_document$defaultView = document.defaultView) == null ? void 0 : _document$defaultView.navigator.clipboard;
137
+ const items = clipboard && (await clipboard.read());
138
+
139
+ if (!items) {
140
+ throw new Error('The Clipboard API is unavailable.');
141
+ }
142
+
143
+ const dt = (0, _.createDataTransfer)();
144
+
145
+ for (const item of items) {
146
+ for (const type of item.types) {
147
+ dt.setData(type, await item.getType(type).then(b => (0, _.readBlobText)(b)));
148
+ }
149
+ }
150
+
151
+ return dt;
152
+ }
153
+
154
+ async function writeDataTransferToClipboard(document, clipboardData) {
155
+ var _document$defaultView2;
156
+
157
+ const clipboard = (_document$defaultView2 = document.defaultView) == null ? void 0 : _document$defaultView2.navigator.clipboard;
158
+ const items = [];
159
+
160
+ for (let i = 0; i < clipboardData.items.length; i++) {
161
+ const dtItem = clipboardData.items[i];
162
+ const blob = (0, _.getBlobFromDataTransferItem)(dtItem);
163
+ items.push(createClipboardItem(blob));
164
+ }
165
+
166
+ const written = clipboard && (await clipboard.write(items).then(() => true, // Can happen with other implementations that e.g. require permissions
167
+
168
+ /* istanbul ignore next */
169
+ () => false));
170
+
171
+ if (!written) {
172
+ throw new Error('The Clipboard API is unavailable.');
173
+ }
174
+ }
175
+ /* istanbul ignore else */
176
+ // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
177
+
178
+
179
+ if (afterEach) {
180
+ afterEach(() => resetClipboardStubOnView(window));
181
+ }
182
+ /* istanbul ignore else */
183
+ // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
184
+
185
+
186
+ if (afterAll) {
187
+ afterAll(() => detachClipboardStubFromView(window));
188
+ }
@@ -0,0 +1,2 @@
1
+ export declare function createDataTransfer(files?: File[]): DataTransfer;
2
+ export declare function getBlobFromDataTransferItem(item: DataTransferItem): Blob;
@@ -0,0 +1,158 @@
1
+ "use strict";
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ exports.createDataTransfer = createDataTransfer;
7
+ exports.getBlobFromDataTransferItem = getBlobFromDataTransferItem;
8
+
9
+ var _FileList = require("./FileList");
10
+
11
+ // DataTransfer is not implemented in jsdom.
12
+ // DataTransfer with FileList is being created by the browser on certain events.
13
+ class DataTransferItemStub {
14
+ constructor(dataOrFile, type) {
15
+ this.kind = void 0;
16
+ this.type = void 0;
17
+ this.file = null;
18
+ this.data = undefined;
19
+
20
+ if (typeof dataOrFile === 'string') {
21
+ this.kind = 'string';
22
+ this.type = String(type);
23
+ this.data = dataOrFile;
24
+ } else {
25
+ this.kind = 'file';
26
+ this.type = dataOrFile.type;
27
+ this.file = dataOrFile;
28
+ }
29
+ }
30
+
31
+ getAsFile() {
32
+ return this.file;
33
+ }
34
+
35
+ getAsString(callback) {
36
+ if (typeof this.data === 'string') {
37
+ callback(this.data);
38
+ }
39
+ }
40
+ /* istanbul ignore next */
41
+
42
+
43
+ webkitGetAsEntry() {
44
+ throw new Error('not implemented');
45
+ }
46
+
47
+ }
48
+
49
+ class DataTransferItemListStub extends Array {
50
+ add(...args) {
51
+ const item = new DataTransferItemStub(args[0], args[1]);
52
+ this.push(item);
53
+ return item;
54
+ }
55
+
56
+ clear() {
57
+ this.splice(0, this.length);
58
+ }
59
+
60
+ remove(index) {
61
+ this.splice(index, 1);
62
+ }
63
+
64
+ }
65
+
66
+ function getTypeMatcher(type, exact) {
67
+ const [group, sub] = type.split('/');
68
+ const isGroup = !sub || sub === '*';
69
+ return item => {
70
+ return exact ? item.type === (isGroup ? group : type) : isGroup ? item.type.startsWith(`${group}/`) : item.type === group;
71
+ };
72
+ }
73
+
74
+ class DataTransferStub {
75
+ constructor() {
76
+ this.dropEffect = 'none';
77
+ this.effectAllowed = 'uninitialized';
78
+ this.items = new DataTransferItemListStub();
79
+ this.files = (0, _FileList.createFileList)([]);
80
+ }
81
+
82
+ getData(format) {
83
+ var _this$items$find;
84
+
85
+ const match = (_this$items$find = this.items.find(getTypeMatcher(format, true))) != null ? _this$items$find : this.items.find(getTypeMatcher(format, false));
86
+ let text = '';
87
+ match == null ? void 0 : match.getAsString(t => {
88
+ text = t;
89
+ });
90
+ return text;
91
+ }
92
+
93
+ setData(format, data) {
94
+ const matchIndex = this.items.findIndex(getTypeMatcher(format, true));
95
+ const item = new DataTransferItemStub(data, format);
96
+
97
+ if (matchIndex >= 0) {
98
+ this.items.splice(matchIndex, 1, item);
99
+ } else {
100
+ this.items.push(item);
101
+ }
102
+ }
103
+
104
+ clearData(format) {
105
+ if (format) {
106
+ const matchIndex = this.items.findIndex(getTypeMatcher(format, true));
107
+
108
+ if (matchIndex >= 0) {
109
+ this.items.remove(matchIndex);
110
+ }
111
+ } else {
112
+ this.items.clear();
113
+ }
114
+ }
115
+
116
+ get types() {
117
+ const t = [];
118
+
119
+ if (this.files.length) {
120
+ t.push('Files');
121
+ }
122
+
123
+ this.items.forEach(i => t.push(i.type));
124
+ Object.freeze(t);
125
+ return t;
126
+ }
127
+ /* istanbul ignore next */
128
+
129
+
130
+ setDragImage() {}
131
+
132
+ }
133
+
134
+ function createDataTransfer(files = []) {
135
+ // Use real DataTransfer if available
136
+ // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
137
+ const dt = typeof DataTransfer === 'undefined' ? new DataTransferStub() :
138
+ /* istanbul ignore next */
139
+ new DataTransfer();
140
+ Object.defineProperty(dt, 'files', {
141
+ get: () => (0, _FileList.createFileList)(files)
142
+ });
143
+ return dt;
144
+ }
145
+
146
+ function getBlobFromDataTransferItem(item) {
147
+ if (item.kind === 'file') {
148
+ return item.getAsFile();
149
+ }
150
+
151
+ let data = '';
152
+ item.getAsString(s => {
153
+ data = s;
154
+ });
155
+ return new Blob([data], {
156
+ type: item.type
157
+ });
158
+ }
@@ -0,0 +1 @@
1
+ export declare function createFileList(files: File[]): FileList;
@@ -0,0 +1,23 @@
1
+ "use strict";
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ exports.createFileList = createFileList;
7
+
8
+ // FileList can not be created per constructor.
9
+ function createFileList(files) {
10
+ const list = { ...files,
11
+ length: files.length,
12
+ item: index => list[index],
13
+ [Symbol.iterator]: function* nextFile() {
14
+ for (let i = 0; i < list.length; i++) {
15
+ yield list[i];
16
+ }
17
+ }
18
+ };
19
+ list.constructor = FileList;
20
+ Object.setPrototypeOf(list, FileList.prototype);
21
+ Object.freeze(list);
22
+ return list;
23
+ }