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