@brightspace-ui/testing 1.50.1 → 1.51.0

package/package.json

@@ -2,7 +2,7 @@
   "name": "@brightspace-ui/testing",
   "description": "Utilities for testing front-end components and applications",
   "type": "module",
-  "version": "1.50.1",
+  "version": "1.51.0",
   "repository": "https://github.com/BrightspaceUI/testing.git",
   "scripts": {
     "lint": "npm run lint:eslint && npm run lint:style",

package/src/browser/commands.js

@@ -40,6 +40,22 @@ export async function dragDropElems(elem, toElem) {
 	await sendMouse({ type: 'up' });
 }
 
+export async function dragElemBy(elem, offsetX = 0, offsetY = 0) {
+	const dragIncrementSize = 10; // To mimic real user dragging
+	const numSteps = Math.ceil(Math.max(Math.abs(offsetX), Math.abs(offsetY)) / dragIncrementSize);
+
+	const position = getElementPosition(elem);
+	await sendMouse({ type: 'move', position: [position.x, position.y] });
+
+	await sendMouse({ type: 'down' });
+	for (let i = 1; i <= numSteps; i++) {
+		const dx = Math.sign(offsetX) * Math.min(Math.abs(offsetX), dragIncrementSize * i);
+		const dy = Math.sign(offsetY) * Math.min(Math.abs(offsetY), dragIncrementSize * i);
+		await sendMouse({ type: 'move', position: [position.x + dx, position.y + dy] });
+	}
+	await sendMouse({ type: 'up' });
+}
+
 export async function focusElem(elem) {
 	await cmdSendKeys({ press: 'Shift' }); // Tab moves focus, Escape causes dismissible things to close
 	elem.focus({ focusVisible: true });

package/src/browser/index.js

@@ -2,6 +2,6 @@ import './vdiff.js';
 import './axe.js';
 
 export { assert, aTimeout, defineCE, expect, html, nextFrame, oneDefaultPreventedEvent, oneEvent, waitUntil } from '@open-wc/testing';
-export { clickAt, clickElem, clickElemAt, dragDropElems, focusElem, hoverAt, hoverElem, hoverElemAt, sendKeys, sendKeysElem, setViewport } from './commands.js';
+export { clickAt, clickElem, clickElemAt, dragDropElems, dragElemBy, focusElem, hoverAt, hoverElem, hoverElemAt, sendKeys, sendKeysElem, setViewport } from './commands.js';
 export { fixture, waitForElem } from './fixture.js';
 export { runConstructor } from './constructor.js';