@testing-library/user-event 13.4.1 → 14.0.0-alpha.10
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.
- package/README.md +4 -0
- package/dist/clear.d.ts +2 -2
- package/dist/clear.js +14 -29
- package/dist/click.d.ts +4 -3
- package/dist/click.js +29 -143
- package/dist/document/index.d.ts +10 -0
- package/dist/document/index.js +100 -0
- package/dist/document/interceptor.d.ts +15 -0
- package/dist/document/interceptor.js +37 -0
- package/dist/document/selection.d.ts +27 -0
- package/dist/document/selection.js +90 -0
- package/dist/document/value.d.ts +18 -0
- package/dist/document/value.js +77 -0
- package/dist/hover.d.ts +3 -3
- package/dist/hover.js +15 -57
- package/dist/index.d.ts +4 -21
- package/dist/index.js +4 -29
- package/dist/keyboard/getNextKeyDef.d.ts +3 -0
- package/dist/keyboard/getNextKeyDef.js +59 -87
- package/dist/keyboard/index.d.ts +1 -0
- package/dist/keyboard/index.js +4 -0
- package/dist/keyboard/keyMap.js +4 -0
- package/dist/keyboard/keyboardImplementation.js +28 -8
- package/dist/keyboard/plugins/arrow.js +7 -12
- package/dist/keyboard/plugins/character.js +29 -57
- package/dist/keyboard/plugins/combination.d.ts +5 -0
- package/dist/keyboard/plugins/combination.js +17 -0
- package/dist/keyboard/plugins/control.js +5 -16
- package/dist/keyboard/plugins/functional.js +33 -15
- package/dist/keyboard/plugins/index.js +5 -5
- package/dist/keyboard/shared/index.d.ts +0 -2
- package/dist/keyboard/shared/index.js +0 -26
- package/dist/keyboard/types.d.ts +8 -0
- package/dist/paste.d.ts +3 -2
- package/dist/paste.js +8 -15
- package/dist/pointer/index.d.ts +18 -0
- package/dist/pointer/index.js +90 -0
- package/dist/pointer/keyMap.d.ts +2 -0
- package/dist/pointer/keyMap.js +29 -0
- package/dist/pointer/parseKeyDef.d.ts +6 -0
- package/dist/pointer/parseKeyDef.js +36 -0
- package/dist/pointer/pointerAction.d.ts +6 -0
- package/dist/pointer/pointerAction.js +52 -0
- package/dist/pointer/pointerMove.d.ts +5 -0
- package/dist/pointer/pointerMove.js +136 -0
- package/dist/pointer/pointerPress.d.ts +7 -0
- package/dist/pointer/pointerPress.js +330 -0
- package/dist/pointer/resolveSelectionTarget.d.ts +5 -0
- package/dist/pointer/resolveSelectionTarget.js +75 -0
- package/dist/pointer/types.d.ts +72 -0
- package/dist/pointer/types.js +1 -0
- package/dist/selectOptions.d.ts +4 -0
- package/dist/{select-options.js → selectOptions.js} +18 -20
- package/dist/setup.d.ts +92 -0
- package/dist/setup.js +203 -0
- package/dist/tab.d.ts +3 -4
- package/dist/tab.js +3 -136
- package/dist/type.d.ts +14 -0
- package/dist/type.js +74 -0
- package/dist/upload.d.ts +4 -3
- package/dist/upload.js +3 -9
- package/dist/utils/edit/calculateNewValue.d.ts +12 -5
- package/dist/utils/edit/calculateNewValue.js +19 -21
- package/dist/utils/edit/editInputElement.d.ts +16 -0
- package/dist/utils/edit/editInputElement.js +53 -0
- package/dist/utils/edit/getValue.d.ts +1 -1
- package/dist/utils/edit/getValue.js +3 -1
- package/dist/utils/edit/isContentEditable.d.ts +4 -0
- package/dist/utils/edit/isContentEditable.js +14 -0
- package/dist/utils/edit/isEditable.d.ts +1 -0
- package/dist/utils/edit/prepareInput.d.ts +7 -0
- package/dist/utils/edit/prepareInput.js +77 -0
- package/dist/{blur.d.ts → utils/focus/blur.d.ts} +0 -0
- package/dist/utils/focus/blur.js +19 -0
- package/dist/{focus.d.ts → utils/focus/focus.d.ts} +0 -0
- package/dist/utils/focus/focus.js +22 -0
- package/dist/utils/focus/getTabDestination.d.ts +1 -0
- package/dist/utils/focus/getTabDestination.js +71 -0
- package/dist/utils/focus/isFocusable.js +1 -3
- package/dist/utils/focus/selectAll.d.ts +5 -0
- package/dist/utils/focus/selectAll.js +51 -0
- package/dist/utils/focus/selection.d.ts +42 -0
- package/dist/utils/focus/selection.js +190 -0
- package/dist/utils/index.d.ts +13 -6
- package/dist/utils/index.js +145 -54
- package/dist/utils/keyDef/readNextDescriptor.d.ts +19 -0
- package/dist/utils/keyDef/readNextDescriptor.js +102 -0
- package/dist/utils/misc/findClosest.d.ts +1 -0
- package/dist/utils/misc/findClosest.js +20 -0
- package/dist/utils/misc/hasFormSubmit.d.ts +1 -0
- package/dist/utils/misc/hasFormSubmit.js +10 -0
- package/dist/utils/misc/isDescendantOrSelf.d.ts +1 -0
- package/dist/utils/misc/isDescendantOrSelf.js +20 -0
- package/dist/utils/pointer/firePointerEvents.d.ts +25 -0
- package/dist/utils/pointer/firePointerEvents.js +112 -0
- package/dist/utils/pointer/mouseButtons.d.ts +12 -0
- package/dist/utils/pointer/mouseButtons.js +45 -0
- package/package.json +4 -3
- package/dist/blur.js +0 -15
- package/dist/dom-helpers.d.ts +0 -3
- package/dist/focus.js +0 -15
- package/dist/keyboard/shared/carryValue.d.ts +0 -2
- package/dist/keyboard/shared/carryValue.js +0 -13
- package/dist/keyboard/shared/fireInputEvent.d.ts +0 -17
- package/dist/keyboard/shared/fireInputEvent.js +0 -110
- package/dist/select-options.d.ts +0 -4
- package/dist/type/index.d.ts +0 -7
- package/dist/type/index.js +0 -33
- package/dist/type/typeImplementation.d.ts +0 -10
- package/dist/type/typeImplementation.js +0 -64
- package/dist/utils/click/getMouseEventOptions.d.ts +0 -31
- package/dist/utils/click/getMouseEventOptions.js +0 -61
- package/dist/utils/edit/cursorPosition.d.ts +0 -2
- package/dist/utils/edit/cursorPosition.js +0 -35
- package/dist/utils/edit/hasUnreliableEmptyValue.d.ts +0 -10
- package/dist/utils/edit/hasUnreliableEmptyValue.js +0 -21
- package/dist/utils/edit/selectionRange.d.ts +0 -16
- package/dist/utils/edit/selectionRange.js +0 -104
- package/dist/utils/misc/isDocument.d.ts +0 -1
- package/dist/utils/misc/isDocument.js +0 -10
- package/dist/utils/misc/isLabelWithInternallyDisabledControl.d.ts +0 -1
- package/dist/utils/misc/isLabelWithInternallyDisabledControl.js +0 -22
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
|
|
3
|
+
Object.defineProperty(exports, "__esModule", {
|
|
4
|
+
value: true
|
|
5
|
+
});
|
|
6
|
+
exports.keydownBehavior = void 0;
|
|
7
|
+
|
|
8
|
+
var _utils = require("../../utils");
|
|
9
|
+
|
|
10
|
+
/**
|
|
11
|
+
* Default behavior for key combinations
|
|
12
|
+
*/
|
|
13
|
+
const keydownBehavior = [{
|
|
14
|
+
matches: (keyDef, element, options, state) => keyDef.code === 'KeyA' && state.modifiers.ctrl,
|
|
15
|
+
handle: (keyDef, element) => (0, _utils.selectAll)(element)
|
|
16
|
+
}];
|
|
17
|
+
exports.keydownBehavior = keydownBehavior;
|
|
@@ -7,8 +7,6 @@ exports.keydownBehavior = void 0;
|
|
|
7
7
|
|
|
8
8
|
var _utils = require("../../utils");
|
|
9
9
|
|
|
10
|
-
var _shared = require("../shared");
|
|
11
|
-
|
|
12
10
|
/**
|
|
13
11
|
* This file should contain behavior for arrow keys as described here:
|
|
14
12
|
* https://w3c.github.io/uievents-code/#key-controlpad-section
|
|
@@ -44,20 +42,11 @@ const keydownBehavior = [{
|
|
|
44
42
|
}
|
|
45
43
|
}
|
|
46
44
|
}, {
|
|
47
|
-
matches: (keyDef, element) => keyDef.key === 'Delete' && (0, _utils.isEditable)(element)
|
|
48
|
-
handle: (keDef, element
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
} = (0, _utils.calculateNewValue)('', element, state.carryValue, undefined, 'forward');
|
|
53
|
-
(0, _shared.fireInputEvent)(element, {
|
|
54
|
-
newValue,
|
|
55
|
-
newSelectionStart,
|
|
56
|
-
eventOverrides: {
|
|
57
|
-
inputType: 'deleteContentForward'
|
|
58
|
-
}
|
|
59
|
-
});
|
|
60
|
-
(0, _shared.carryValue)(element, state, newValue);
|
|
45
|
+
matches: (keyDef, element) => keyDef.key === 'Delete' && (0, _utils.isEditable)(element),
|
|
46
|
+
handle: (keDef, element) => {
|
|
47
|
+
var _prepareInput;
|
|
48
|
+
|
|
49
|
+
(_prepareInput = (0, _utils.prepareInput)('', element, 'deleteContentForward')) == null ? void 0 : _prepareInput.commit();
|
|
61
50
|
}
|
|
62
51
|
}];
|
|
63
52
|
exports.keydownBehavior = keydownBehavior;
|
|
@@ -7,12 +7,12 @@ exports.preKeyupBehavior = exports.preKeydownBehavior = exports.postKeyupBehavio
|
|
|
7
7
|
|
|
8
8
|
var _dom = require("@testing-library/dom");
|
|
9
9
|
|
|
10
|
+
var _document = require("../../document");
|
|
11
|
+
|
|
10
12
|
var _utils = require("../../utils");
|
|
11
13
|
|
|
12
14
|
var _getEventProps = require("../getEventProps");
|
|
13
15
|
|
|
14
|
-
var _shared = require("../shared");
|
|
15
|
-
|
|
16
16
|
/**
|
|
17
17
|
* This file should contain behavior for functional keys as described here:
|
|
18
18
|
* https://w3c.github.io/uievents-code/#key-alphanumeric-functional
|
|
@@ -53,24 +53,42 @@ const keydownBehavior = [{
|
|
|
53
53
|
state.modifiers.caps = !state.modifiers.caps;
|
|
54
54
|
}
|
|
55
55
|
}, {
|
|
56
|
-
matches: (keyDef, element) => keyDef.key === 'Backspace' && (0, _utils.isEditable)(element)
|
|
56
|
+
matches: (keyDef, element) => keyDef.key === 'Backspace' && (0, _utils.isEditable)(element),
|
|
57
|
+
handle: (keyDef, element) => {
|
|
58
|
+
var _prepareInput;
|
|
59
|
+
|
|
60
|
+
(_prepareInput = (0, _utils.prepareInput)('', element, 'deleteContentBackward')) == null ? void 0 : _prepareInput.commit();
|
|
61
|
+
}
|
|
62
|
+
}, {
|
|
63
|
+
matches: keyDef => keyDef.key === 'Tab',
|
|
57
64
|
handle: (keyDef, element, options, state) => {
|
|
58
|
-
const
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
65
|
+
const dest = (0, _utils.getTabDestination)(element, state.modifiers.shift);
|
|
66
|
+
|
|
67
|
+
if (dest === element.ownerDocument.body) {
|
|
68
|
+
(0, _utils.blur)(element);
|
|
69
|
+
} else {
|
|
70
|
+
(0, _utils.focus)(dest);
|
|
71
|
+
|
|
72
|
+
if ((0, _utils.isElementType)(dest, ['input', 'textarea'])) {
|
|
73
|
+
(0, _document.setUISelection)(dest, {
|
|
74
|
+
anchorOffset: 0,
|
|
75
|
+
focusOffset: dest.value.length
|
|
76
|
+
});
|
|
67
77
|
}
|
|
68
|
-
}
|
|
69
|
-
(0, _shared.carryValue)(element, state, newValue);
|
|
78
|
+
}
|
|
70
79
|
}
|
|
71
80
|
}];
|
|
72
81
|
exports.keydownBehavior = keydownBehavior;
|
|
73
82
|
const keypressBehavior = [{
|
|
83
|
+
matches: (keyDef, element) => keyDef.key === 'Enter' && (0, _utils.isElementType)(element, 'input') && ['checkbox', 'radio'].includes(element.type),
|
|
84
|
+
handle: (keyDef, element) => {
|
|
85
|
+
const form = element.form;
|
|
86
|
+
|
|
87
|
+
if ((0, _utils.hasFormSubmit)(form)) {
|
|
88
|
+
_dom.fireEvent.submit(form);
|
|
89
|
+
}
|
|
90
|
+
}
|
|
91
|
+
}, {
|
|
74
92
|
matches: (keyDef, element) => keyDef.key === 'Enter' && ((0, _utils.isClickableInput)(element) || // Links with href defined should handle Enter the same as a click
|
|
75
93
|
(0, _utils.isElementType)(element, 'a') && Boolean(element.href)),
|
|
76
94
|
handle: (keyDef, element, options, state) => {
|
|
@@ -81,7 +99,7 @@ const keypressBehavior = [{
|
|
|
81
99
|
handle: (keyDef, element) => {
|
|
82
100
|
const form = element.form;
|
|
83
101
|
|
|
84
|
-
if (form && (form.querySelectorAll('input').length === 1 ||
|
|
102
|
+
if (form && (form.querySelectorAll('input').length === 1 || (0, _utils.hasFormSubmit)(form))) {
|
|
85
103
|
_dom.fireEvent.submit(form);
|
|
86
104
|
}
|
|
87
105
|
}
|
|
@@ -15,22 +15,22 @@ var characterKeys = _interopRequireWildcard(require("./character"));
|
|
|
15
15
|
|
|
16
16
|
var functionalKeys = _interopRequireWildcard(require("./functional"));
|
|
17
17
|
|
|
18
|
+
var combination = _interopRequireWildcard(require("./combination"));
|
|
19
|
+
|
|
18
20
|
function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
|
|
19
21
|
|
|
20
22
|
function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
|
|
21
23
|
|
|
22
24
|
const replaceBehavior = [{
|
|
23
25
|
matches: (keyDef, element) => keyDef.key === 'selectall' && (0, _utils.isElementType)(element, ['input', 'textarea']),
|
|
24
|
-
handle: (keyDef, element
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
(0, _utils.setSelectionRange)(element, 0, ((_state$carryValue = state.carryValue) != null ? _state$carryValue : element.value).length);
|
|
26
|
+
handle: (keyDef, element) => {
|
|
27
|
+
(0, _utils.setSelectionRange)(element, 0, (0, _utils.getValue)(element).length);
|
|
28
28
|
}
|
|
29
29
|
}];
|
|
30
30
|
exports.replaceBehavior = replaceBehavior;
|
|
31
31
|
const preKeydownBehavior = [...functionalKeys.preKeydownBehavior];
|
|
32
32
|
exports.preKeydownBehavior = preKeydownBehavior;
|
|
33
|
-
const keydownBehavior = [...arrowKeys.keydownBehavior, ...controlKeys.keydownBehavior, ...functionalKeys.keydownBehavior];
|
|
33
|
+
const keydownBehavior = [...arrowKeys.keydownBehavior, ...controlKeys.keydownBehavior, ...functionalKeys.keydownBehavior, ...combination.keydownBehavior];
|
|
34
34
|
exports.keydownBehavior = keydownBehavior;
|
|
35
35
|
const keypressBehavior = [...functionalKeys.keypressBehavior, ...characterKeys.keypressBehavior];
|
|
36
36
|
exports.keypressBehavior = keypressBehavior;
|
|
@@ -4,19 +4,6 @@ Object.defineProperty(exports, "__esModule", {
|
|
|
4
4
|
value: true
|
|
5
5
|
});
|
|
6
6
|
|
|
7
|
-
var _carryValue = require("./carryValue");
|
|
8
|
-
|
|
9
|
-
Object.keys(_carryValue).forEach(function (key) {
|
|
10
|
-
if (key === "default" || key === "__esModule") return;
|
|
11
|
-
if (key in exports && exports[key] === _carryValue[key]) return;
|
|
12
|
-
Object.defineProperty(exports, key, {
|
|
13
|
-
enumerable: true,
|
|
14
|
-
get: function () {
|
|
15
|
-
return _carryValue[key];
|
|
16
|
-
}
|
|
17
|
-
});
|
|
18
|
-
});
|
|
19
|
-
|
|
20
7
|
var _fireChangeForInputTimeIfValid = require("./fireChangeForInputTimeIfValid");
|
|
21
8
|
|
|
22
9
|
Object.keys(_fireChangeForInputTimeIfValid).forEach(function (key) {
|
|
@@ -28,17 +15,4 @@ Object.keys(_fireChangeForInputTimeIfValid).forEach(function (key) {
|
|
|
28
15
|
return _fireChangeForInputTimeIfValid[key];
|
|
29
16
|
}
|
|
30
17
|
});
|
|
31
|
-
});
|
|
32
|
-
|
|
33
|
-
var _fireInputEvent = require("./fireInputEvent");
|
|
34
|
-
|
|
35
|
-
Object.keys(_fireInputEvent).forEach(function (key) {
|
|
36
|
-
if (key === "default" || key === "__esModule") return;
|
|
37
|
-
if (key in exports && exports[key] === _fireInputEvent[key]) return;
|
|
38
|
-
Object.defineProperty(exports, key, {
|
|
39
|
-
enumerable: true,
|
|
40
|
-
get: function () {
|
|
41
|
-
return _fireInputEvent[key];
|
|
42
|
-
}
|
|
43
|
-
});
|
|
44
18
|
});
|
package/dist/keyboard/types.d.ts
CHANGED
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { getNextKeyDef } from './getNextKeyDef';
|
|
1
2
|
/**
|
|
2
3
|
* @internal Do not create/alter this by yourself as this type might be subject to changes.
|
|
3
4
|
*/
|
|
@@ -28,6 +29,9 @@ export declare type keyboardState = {
|
|
|
28
29
|
For HTMLInputElements type='number':
|
|
29
30
|
If the last input char is '.', '-' or 'e',
|
|
30
31
|
the IDL value attribute does not reflect the input value.
|
|
32
|
+
|
|
33
|
+
@deprecated The document state workaround in `src/document/value.ts` keeps track
|
|
34
|
+
of UI value diverging from value property.
|
|
31
35
|
*/
|
|
32
36
|
carryValue?: string;
|
|
33
37
|
/**
|
|
@@ -35,6 +39,10 @@ export declare type keyboardState = {
|
|
|
35
39
|
E.g. ^1
|
|
36
40
|
*/
|
|
37
41
|
carryChar: string;
|
|
42
|
+
/**
|
|
43
|
+
Repeat keydown and keypress event
|
|
44
|
+
*/
|
|
45
|
+
repeatKey?: ReturnType<typeof getNextKeyDef>;
|
|
38
46
|
};
|
|
39
47
|
export declare type keyboardOptions = {
|
|
40
48
|
/** Document in which to perform the events */
|
package/dist/paste.d.ts
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
|
+
import type { UserEvent } from './setup';
|
|
1
2
|
interface pasteOptions {
|
|
2
3
|
initialSelectionStart?: number;
|
|
3
4
|
initialSelectionEnd?: number;
|
|
4
5
|
}
|
|
5
|
-
declare function paste(element: HTMLElement, text: string, init?: ClipboardEventInit, { initialSelectionStart, initialSelectionEnd }?: pasteOptions): void;
|
|
6
|
-
export {
|
|
6
|
+
export declare function paste(this: UserEvent, element: HTMLElement, text: string, init?: ClipboardEventInit, { initialSelectionStart, initialSelectionEnd }?: pasteOptions): void;
|
|
7
|
+
export {};
|
package/dist/paste.js
CHANGED
|
@@ -17,6 +17,8 @@ function paste(element, text, init, {
|
|
|
17
17
|
initialSelectionStart,
|
|
18
18
|
initialSelectionEnd
|
|
19
19
|
} = {}) {
|
|
20
|
+
var _prepareInput;
|
|
21
|
+
|
|
20
22
|
// TODO: implement for contenteditable
|
|
21
23
|
if (!isSupportedElement(element)) {
|
|
22
24
|
throw new TypeError(`The given ${element.tagName} element is currently unsupported.
|
|
@@ -47,21 +49,12 @@ function paste(element, text, init, {
|
|
|
47
49
|
}
|
|
48
50
|
|
|
49
51
|
text = text.substr(0, (0, _utils.getSpaceUntilMaxLength)(element));
|
|
50
|
-
const
|
|
51
|
-
|
|
52
|
-
newSelectionStart
|
|
53
|
-
} = (0, _utils.calculateNewValue)(text, element);
|
|
52
|
+
const inputRange = (0, _utils.getInputRange)(element);
|
|
53
|
+
/* istanbul ignore if */
|
|
54
54
|
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
value: newValue
|
|
59
|
-
}
|
|
60
|
-
});
|
|
55
|
+
if (!inputRange) {
|
|
56
|
+
return;
|
|
57
|
+
}
|
|
61
58
|
|
|
62
|
-
(0, _utils.
|
|
63
|
-
{
|
|
64
|
-
newSelectionStart,
|
|
65
|
-
selectionEnd: newSelectionStart
|
|
66
|
-
}, {});
|
|
59
|
+
(_prepareInput = (0, _utils.prepareInput)(text, element, 'insertFromPaste')) == null ? void 0 : _prepareInput.commit();
|
|
67
60
|
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import { PointerAction, PointerActionTarget } from './pointerAction';
|
|
2
|
+
import type { inputDeviceState, pointerOptions, pointerState } from './types';
|
|
3
|
+
export declare function pointer(input: PointerInput, options?: Partial<pointerOptions & {
|
|
4
|
+
delay: 0;
|
|
5
|
+
} & inputDeviceState>): pointerState;
|
|
6
|
+
export declare function pointer(input: PointerInput, options: Partial<pointerOptions & {
|
|
7
|
+
delay: number;
|
|
8
|
+
} & inputDeviceState>): Promise<pointerState>;
|
|
9
|
+
declare type PointerActionInput = string | ({
|
|
10
|
+
keys: string;
|
|
11
|
+
} & PointerActionTarget) | PointerAction;
|
|
12
|
+
declare type PointerInput = PointerActionInput | Array<PointerActionInput>;
|
|
13
|
+
export declare function pointerImplementationWrapper(input: PointerInput, config: Partial<pointerOptions & inputDeviceState>): {
|
|
14
|
+
promise: Promise<unknown[]>;
|
|
15
|
+
pointerState: pointerState;
|
|
16
|
+
};
|
|
17
|
+
export declare function createPointerState(): pointerState;
|
|
18
|
+
export {};
|
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
|
|
3
|
+
Object.defineProperty(exports, "__esModule", {
|
|
4
|
+
value: true
|
|
5
|
+
});
|
|
6
|
+
exports.createPointerState = createPointerState;
|
|
7
|
+
exports.pointer = pointer;
|
|
8
|
+
exports.pointerImplementationWrapper = pointerImplementationWrapper;
|
|
9
|
+
|
|
10
|
+
var _dom = require("@testing-library/dom");
|
|
11
|
+
|
|
12
|
+
var _keyboard = require("../keyboard");
|
|
13
|
+
|
|
14
|
+
var _parseKeyDef = require("./parseKeyDef");
|
|
15
|
+
|
|
16
|
+
var _keyMap = require("./keyMap");
|
|
17
|
+
|
|
18
|
+
var _pointerAction = require("./pointerAction");
|
|
19
|
+
|
|
20
|
+
function pointer(input, options = {}) {
|
|
21
|
+
var _options$delay;
|
|
22
|
+
|
|
23
|
+
const {
|
|
24
|
+
promise,
|
|
25
|
+
pointerState
|
|
26
|
+
} = pointerImplementationWrapper(input, options);
|
|
27
|
+
|
|
28
|
+
if (((_options$delay = options.delay) != null ? _options$delay : 0) > 0) {
|
|
29
|
+
return (0, _dom.getConfig)().asyncWrapper(() => promise.then(() => pointerState));
|
|
30
|
+
} else {
|
|
31
|
+
// prevent users from dealing with UnhandledPromiseRejectionWarning in sync call
|
|
32
|
+
promise.catch(console.error);
|
|
33
|
+
return pointerState;
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
function pointerImplementationWrapper(input, config) {
|
|
38
|
+
const {
|
|
39
|
+
pointerState = createPointerState(),
|
|
40
|
+
keyboardState = (0, _keyboard.createKeyboardState)(),
|
|
41
|
+
delay = 0,
|
|
42
|
+
pointerMap = _keyMap.defaultKeyMap
|
|
43
|
+
} = config;
|
|
44
|
+
const options = {
|
|
45
|
+
delay,
|
|
46
|
+
pointerMap
|
|
47
|
+
};
|
|
48
|
+
const actions = [];
|
|
49
|
+
(Array.isArray(input) ? input : [input]).forEach(actionInput => {
|
|
50
|
+
if (typeof actionInput === 'string') {
|
|
51
|
+
actions.push(...(0, _parseKeyDef.parseKeyDef)(actionInput, options));
|
|
52
|
+
} else if ('keys' in actionInput) {
|
|
53
|
+
actions.push(...(0, _parseKeyDef.parseKeyDef)(actionInput.keys, options).map(i => ({ ...actionInput,
|
|
54
|
+
...i
|
|
55
|
+
})));
|
|
56
|
+
} else {
|
|
57
|
+
actions.push(actionInput);
|
|
58
|
+
}
|
|
59
|
+
});
|
|
60
|
+
return {
|
|
61
|
+
promise: (0, _pointerAction.pointerAction)(actions, options, {
|
|
62
|
+
pointerState,
|
|
63
|
+
keyboardState
|
|
64
|
+
}),
|
|
65
|
+
pointerState
|
|
66
|
+
};
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
function createPointerState() {
|
|
70
|
+
return {
|
|
71
|
+
pointerId: 1,
|
|
72
|
+
position: {
|
|
73
|
+
mouse: {
|
|
74
|
+
pointerType: 'mouse',
|
|
75
|
+
pointerId: 1,
|
|
76
|
+
coords: {
|
|
77
|
+
clientX: 0,
|
|
78
|
+
clientY: 0,
|
|
79
|
+
offsetX: 0,
|
|
80
|
+
offsetY: 0,
|
|
81
|
+
pageX: 0,
|
|
82
|
+
pageY: 0,
|
|
83
|
+
x: 0,
|
|
84
|
+
y: 0
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
},
|
|
88
|
+
pressed: []
|
|
89
|
+
};
|
|
90
|
+
}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
|
|
3
|
+
Object.defineProperty(exports, "__esModule", {
|
|
4
|
+
value: true
|
|
5
|
+
});
|
|
6
|
+
exports.defaultKeyMap = void 0;
|
|
7
|
+
const defaultKeyMap = [{
|
|
8
|
+
name: 'MouseLeft',
|
|
9
|
+
pointerType: 'mouse',
|
|
10
|
+
button: 'primary'
|
|
11
|
+
}, {
|
|
12
|
+
name: 'MouseRight',
|
|
13
|
+
pointerType: 'mouse',
|
|
14
|
+
button: 'secondary'
|
|
15
|
+
}, {
|
|
16
|
+
name: 'MouseMiddle',
|
|
17
|
+
pointerType: 'mouse',
|
|
18
|
+
button: 'auxiliary'
|
|
19
|
+
}, {
|
|
20
|
+
name: 'TouchA',
|
|
21
|
+
pointerType: 'touch'
|
|
22
|
+
}, {
|
|
23
|
+
name: 'TouchB',
|
|
24
|
+
pointerType: 'touch'
|
|
25
|
+
}, {
|
|
26
|
+
name: 'TouchC',
|
|
27
|
+
pointerType: 'touch'
|
|
28
|
+
}];
|
|
29
|
+
exports.defaultKeyMap = defaultKeyMap;
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
|
|
3
|
+
Object.defineProperty(exports, "__esModule", {
|
|
4
|
+
value: true
|
|
5
|
+
});
|
|
6
|
+
exports.parseKeyDef = parseKeyDef;
|
|
7
|
+
|
|
8
|
+
var _utils = require("../utils");
|
|
9
|
+
|
|
10
|
+
function parseKeyDef(keys, {
|
|
11
|
+
pointerMap
|
|
12
|
+
}) {
|
|
13
|
+
const defs = [];
|
|
14
|
+
|
|
15
|
+
do {
|
|
16
|
+
const {
|
|
17
|
+
descriptor,
|
|
18
|
+
consumedLength,
|
|
19
|
+
releasePrevious,
|
|
20
|
+
releaseSelf = true
|
|
21
|
+
} = (0, _utils.readNextDescriptor)(keys);
|
|
22
|
+
const keyDef = pointerMap.find(p => p.name === descriptor);
|
|
23
|
+
|
|
24
|
+
if (keyDef) {
|
|
25
|
+
defs.push({
|
|
26
|
+
keyDef,
|
|
27
|
+
releasePrevious,
|
|
28
|
+
releaseSelf
|
|
29
|
+
});
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
keys = keys.slice(consumedLength);
|
|
33
|
+
} while (keys);
|
|
34
|
+
|
|
35
|
+
return defs;
|
|
36
|
+
}
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
import { PointerMoveAction } from './pointerMove';
|
|
2
|
+
import { PointerPressAction } from './pointerPress';
|
|
3
|
+
import { inputDeviceState, pointerOptions, PointerTarget, SelectionTarget } from './types';
|
|
4
|
+
export declare type PointerActionTarget = Partial<PointerTarget> & Partial<SelectionTarget>;
|
|
5
|
+
export declare type PointerAction = PointerActionTarget & (Omit<PointerPressAction, 'target' | 'coords'> | Omit<PointerMoveAction, 'target' | 'coords'>);
|
|
6
|
+
export declare function pointerAction(actions: PointerAction[], options: pointerOptions, state: inputDeviceState): Promise<unknown[]>;
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
|
|
3
|
+
Object.defineProperty(exports, "__esModule", {
|
|
4
|
+
value: true
|
|
5
|
+
});
|
|
6
|
+
exports.pointerAction = pointerAction;
|
|
7
|
+
|
|
8
|
+
var _utils = require("../utils");
|
|
9
|
+
|
|
10
|
+
var _pointerMove = require("./pointerMove");
|
|
11
|
+
|
|
12
|
+
var _pointerPress = require("./pointerPress");
|
|
13
|
+
|
|
14
|
+
async function pointerAction(actions, options, state) {
|
|
15
|
+
const ret = [];
|
|
16
|
+
|
|
17
|
+
for (let i = 0; i < actions.length; i++) {
|
|
18
|
+
var _action$target, _action$coords;
|
|
19
|
+
|
|
20
|
+
const action = actions[i];
|
|
21
|
+
const pointerName = 'pointerName' in action && action.pointerName ? action.pointerName : 'keyDef' in action ? action.keyDef.pointerType === 'touch' ? action.keyDef.name : action.keyDef.pointerType : 'mouse';
|
|
22
|
+
const target = (_action$target = action.target) != null ? _action$target : getPrevTarget(pointerName, state.pointerState);
|
|
23
|
+
const coords = (_action$coords = action.coords) != null ? _action$coords : pointerName in state.pointerState.position ? state.pointerState.position[pointerName].coords : undefined;
|
|
24
|
+
const promise = 'keyDef' in action ? (0, _pointerPress.pointerPress)({ ...action,
|
|
25
|
+
target,
|
|
26
|
+
coords
|
|
27
|
+
}, state) : (0, _pointerMove.pointerMove)({ ...action,
|
|
28
|
+
target,
|
|
29
|
+
coords
|
|
30
|
+
}, state);
|
|
31
|
+
ret.push(promise);
|
|
32
|
+
|
|
33
|
+
if (options.delay > 0) {
|
|
34
|
+
await promise;
|
|
35
|
+
|
|
36
|
+
if (i < actions.length - 1) {
|
|
37
|
+
await (0, _utils.wait)(options.delay);
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
delete state.pointerState.activeClickCount;
|
|
43
|
+
return Promise.all(ret);
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
function getPrevTarget(pointerName, state) {
|
|
47
|
+
if (!(pointerName in state.position) || !state.position[pointerName].target) {
|
|
48
|
+
throw new Error('This pointer has no previous position. Provide a target property!');
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
return state.position[pointerName].target;
|
|
52
|
+
}
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
import { inputDeviceState, PointerTarget, SelectionTarget } from './types';
|
|
2
|
+
export interface PointerMoveAction extends PointerTarget, SelectionTarget {
|
|
3
|
+
pointerName?: string;
|
|
4
|
+
}
|
|
5
|
+
export declare function pointerMove({ pointerName, target, coords, node, offset }: PointerMoveAction, { pointerState, keyboardState }: inputDeviceState): Promise<void>;
|
|
@@ -0,0 +1,136 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
|
|
3
|
+
Object.defineProperty(exports, "__esModule", {
|
|
4
|
+
value: true
|
|
5
|
+
});
|
|
6
|
+
exports.pointerMove = pointerMove;
|
|
7
|
+
|
|
8
|
+
var _document = require("../document");
|
|
9
|
+
|
|
10
|
+
var _utils = require("../utils");
|
|
11
|
+
|
|
12
|
+
var _resolveSelectionTarget = require("./resolveSelectionTarget");
|
|
13
|
+
|
|
14
|
+
async function pointerMove({
|
|
15
|
+
pointerName = 'mouse',
|
|
16
|
+
target,
|
|
17
|
+
coords,
|
|
18
|
+
node,
|
|
19
|
+
offset
|
|
20
|
+
}, {
|
|
21
|
+
pointerState,
|
|
22
|
+
keyboardState
|
|
23
|
+
}) {
|
|
24
|
+
if (!(pointerName in pointerState.position)) {
|
|
25
|
+
throw new Error(`Trying to move pointer "${pointerName}" which does not exist.`);
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
const {
|
|
29
|
+
pointerId,
|
|
30
|
+
pointerType,
|
|
31
|
+
target: prevTarget,
|
|
32
|
+
coords: prevCoords,
|
|
33
|
+
selectionRange
|
|
34
|
+
} = pointerState.position[pointerName];
|
|
35
|
+
|
|
36
|
+
if (prevTarget && prevTarget !== target) {
|
|
37
|
+
// Here we could probably calculate a few coords to a fake boundary(?)
|
|
38
|
+
fireMove(prevTarget, prevCoords);
|
|
39
|
+
|
|
40
|
+
if (!(0, _utils.isDescendantOrSelf)(target, prevTarget)) {
|
|
41
|
+
fireLeave(prevTarget, prevCoords);
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
pointerState.position[pointerName] = { ...pointerState.position[pointerName],
|
|
46
|
+
target,
|
|
47
|
+
coords
|
|
48
|
+
};
|
|
49
|
+
|
|
50
|
+
if (prevTarget !== target) {
|
|
51
|
+
if (!prevTarget || !(0, _utils.isDescendantOrSelf)(prevTarget, target)) {
|
|
52
|
+
fireEnter(target, coords);
|
|
53
|
+
}
|
|
54
|
+
} // TODO: drag if the target didn't change?
|
|
55
|
+
// Here we could probably calculate a few coords leading up to the final position
|
|
56
|
+
|
|
57
|
+
|
|
58
|
+
fireMove(target, coords);
|
|
59
|
+
|
|
60
|
+
if (selectionRange) {
|
|
61
|
+
// TODO: support extending range (shift)
|
|
62
|
+
const selectionFocus = (0, _resolveSelectionTarget.resolveSelectionTarget)({
|
|
63
|
+
target,
|
|
64
|
+
node,
|
|
65
|
+
offset
|
|
66
|
+
});
|
|
67
|
+
|
|
68
|
+
if ('node' in selectionRange) {
|
|
69
|
+
// When the mouse is dragged outside of an input/textarea,
|
|
70
|
+
// the selection is extended to the beginning or end of the input
|
|
71
|
+
// depending on pointer position.
|
|
72
|
+
// TODO: extend selection according to pointer position
|
|
73
|
+
|
|
74
|
+
/* istanbul ignore else */
|
|
75
|
+
if (selectionFocus.node === selectionRange.node) {
|
|
76
|
+
const anchorOffset = selectionFocus.offset < selectionRange.start ? selectionRange.end : selectionRange.start;
|
|
77
|
+
const focusOffset = selectionFocus.offset > selectionRange.end || selectionFocus.offset < selectionRange.start ? selectionFocus.offset : selectionRange.end;
|
|
78
|
+
(0, _document.setUISelection)(selectionRange.node, {
|
|
79
|
+
anchorOffset,
|
|
80
|
+
focusOffset
|
|
81
|
+
});
|
|
82
|
+
}
|
|
83
|
+
} else {
|
|
84
|
+
const range = selectionRange.cloneRange();
|
|
85
|
+
const cmp = range.comparePoint(selectionFocus.node, selectionFocus.offset);
|
|
86
|
+
|
|
87
|
+
if (cmp < 0) {
|
|
88
|
+
range.setStart(selectionFocus.node, selectionFocus.offset);
|
|
89
|
+
} else if (cmp > 0) {
|
|
90
|
+
range.setEnd(selectionFocus.node, selectionFocus.offset);
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
const selection = target.ownerDocument.getSelection();
|
|
94
|
+
selection.removeAllRanges();
|
|
95
|
+
selection.addRange(range.cloneRange());
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
function fireMove(eventTarget, eventCoords) {
|
|
100
|
+
fire(eventTarget, 'pointermove', eventCoords);
|
|
101
|
+
|
|
102
|
+
if (pointerType === 'mouse' && !(0, _utils.isDisabled)(eventTarget)) {
|
|
103
|
+
fire(eventTarget, 'mousemove', eventCoords);
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
|
|
107
|
+
function fireLeave(eventTarget, eventCoords) {
|
|
108
|
+
fire(eventTarget, 'pointerout', eventCoords);
|
|
109
|
+
fire(eventTarget, 'pointerleave', eventCoords);
|
|
110
|
+
|
|
111
|
+
if (pointerType === 'mouse' && !(0, _utils.isDisabled)(eventTarget)) {
|
|
112
|
+
fire(eventTarget, 'mouseout', eventCoords);
|
|
113
|
+
fire(eventTarget, 'mouseleave', eventCoords);
|
|
114
|
+
}
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
function fireEnter(eventTarget, eventCoords) {
|
|
118
|
+
fire(eventTarget, 'pointerover', eventCoords);
|
|
119
|
+
fire(eventTarget, 'pointerenter', eventCoords);
|
|
120
|
+
|
|
121
|
+
if (pointerType === 'mouse' && !(0, _utils.isDisabled)(eventTarget)) {
|
|
122
|
+
fire(eventTarget, 'mouseover', eventCoords);
|
|
123
|
+
fire(eventTarget, 'mouseenter', eventCoords);
|
|
124
|
+
}
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
function fire(eventTarget, type, eventCoords) {
|
|
128
|
+
return (0, _utils.firePointerEvent)(eventTarget, type, {
|
|
129
|
+
pointerState,
|
|
130
|
+
keyboardState,
|
|
131
|
+
coords: eventCoords,
|
|
132
|
+
pointerId,
|
|
133
|
+
pointerType
|
|
134
|
+
});
|
|
135
|
+
}
|
|
136
|
+
}
|