feat: add mousedown and mouseup events

Author: criticalbh

Diff for: examples/mouse-event-example.js

@@ -0,0 +1,18 @@
+const { Chromeless } = require('chromeless')
+
+async function run() {
+    const chromeless = new Chromeless()
+
+    const screenshot = await chromeless
+        .goto('https://www.google.com')
+        .mousedown('input[name="btnI"]')
+        .mouseup('input[name="btnI"]')
+        .wait('.latest-doodle')
+        .screenshot()
+
+    console.log(screenshot)
+
+    await chromeless.end()
+}
+
+run().catch(console.error.bind(console))

Diff for: src/api.ts

@@ -124,12 +124,14 @@ export default class Chromeless<T extends any> implements Promise<T> {
     throw new Error('Not implemented yet')
   }
 
-  mousedown(): Chromeless<T> {
-    throw new Error('Not implemented yet')
+  mousedown(selector: string): Chromeless<T> {
+      this.queue.enqueue({type: 'mousedown', selector})
+      return this
   }
 
-  mouseup(): Chromeless<T> {
-    throw new Error('Not implemented yet')
+  mouseup(selector: string): Chromeless<T> {
+      this.queue.enqueue({type: 'mouseup', selector})
+      return this
   }
 
   mouseover(): Chromeless<T> {

Diff for: src/chrome/local-runtime.ts

@@ -15,7 +15,7 @@ import {
   press,
   clearCookies,
   getCookies,
-  setCookies, getAllCookies, version,
+  setCookies, getAllCookies, version, mousedown, mouseup
 } from '../util'
 
 export default class LocalRuntime {
@@ -65,6 +65,10 @@ export default class LocalRuntime {
         return this.cookiesGetAll()
       case 'cookiesSet':
         return this.cookiesSet(command.nameOrCookies, command.value)
+      case 'mousedown':
+        return this.mousedown(command.selector)
+      case 'mouseup':
+        return this.mousup(command.selector)
       default:
         throw new Error(`No such command: ${JSON.stringify(command)}`)
     }
@@ -114,6 +118,38 @@ export default class LocalRuntime {
     return scrollTo(this.client, x, y)
   }
 
+  private async mousedown(selector: string): Promise<void> {
+      if (this.chromlessOptions.implicitWait) {
+          this.log(`mousedown(): Waiting for ${selector}`)
+          await waitForNode(this.client, selector, this.chromlessOptions.waitTimeout)
+      }
+
+      const exists = await nodeExists(this.client, selector)
+      if (!exists) {
+          throw new Error(`mousedown(): node for selector ${selector} doesn't exist`)
+      }
+
+      const {scale} = this.chromlessOptions.viewport
+      await mousedown(this.client, selector, scale)
+      this.log(`Mousedown on ${selector}`)
+  }
+
+  private async mousup(selector: string): Promise<void> {
+      if (this.chromlessOptions.implicitWait) {
+          this.log(`mouseup(): Waiting for ${selector}`)
+          await waitForNode(this.client, selector, this.chromlessOptions.waitTimeout)
+      }
+
+      const exists = await nodeExists(this.client, selector)
+      if (!exists) {
+          throw new Error(`mouseup(): node for selector ${selector} doesn't exist`)
+      }
+
+      const {scale} = this.chromlessOptions.viewport
+      await mouseup(this.client, selector, scale)
+      this.log(`Mouseup on ${selector}`)
+  }
+
   async type(text: string, selector?: string): Promise<void> {
     if (selector) {
       if (this.chromlessOptions.implicitWait) {

Diff for: src/types.ts

@@ -107,6 +107,14 @@ export type Command =
       type: 'cookiesGet'
       nameOrQuery?: string | CookieQuery
     }
+  | {
+      type: 'mousedown',
+      selector: string
+    }
+  | {
+      type: 'mouseup',
+      selector: string
+    }
 
 export interface Cookie {
   url?: string

Diff for: src/util.ts

@@ -271,6 +271,40 @@ export async function setCookies(client: Client, cookies: Cookie[]): Promise<voi
   }
 }
 
+export async function mousedown(client: Client, selector: string, scale: number) {
+    const clientRect = await getClientRect(client, selector)
+    const {Input} = client
+
+    const options = {
+        x: Math.round((clientRect.left + clientRect.width / 2) * scale),
+        y: Math.round((clientRect.top + clientRect.height / 2) * scale),
+        button: 'left',
+        clickCount: 1,
+    }
+
+    await Input.dispatchMouseEvent({
+        ...options,
+        type: 'mousePressed'
+    })
+}
+
+export async function mouseup(client: Client, selector: string, scale: number) {
+    const clientRect = await getClientRect(client, selector)
+    const {Input} = client
+
+    const options = {
+        x: Math.round((clientRect.left + clientRect.width / 2) * scale),
+        y: Math.round((clientRect.top + clientRect.height / 2) * scale),
+        button: 'left',
+        clickCount: 1,
+    }
+
+    await Input.dispatchMouseEvent({
+        ...options,
+        type: 'mouseReleased'
+    })
+}
+
 function getUrlFromCookie(cookie: Cookie) {
   const domain = cookie.domain.slice(1, cookie.domain.length)
   return `https://${domain}`