Method moveCursorTo

lib/helper/Puppeteer.js:825–852

* {{> moveCursorTo }}

(locator, offsetX = 0, offsetY = 0)

   * {{> moveCursorTo }}
   */
  async moveCursorTo(locator, offsetX = 0, offsetY = 0) {
    let context = null
    if (typeof offsetX !== 'number') {
      context = offsetX
      offsetX = 0
    }

    let el
    if (context) {
      const contextEls = await findElements.call(this, this.page, context)
      assertElementExists(contextEls, context, 'Context element')
      const els = await findElements.call(this, contextEls[0], locator)
      if (!els || els.length === 0) {
        throw new ElementNotFound(locator, 'Element to move cursor to')
      }
      el = els[0]
    } else {
      el = await this._locateElement(locator)
      if (!el) {
        throw new ElementNotFound(locator, 'Element to move cursor to')
      }
    }

    // Use manual mouse.move instead of .hover() so the offset can be added to the coordinates
    const { x, y } = await getClickablePoint(el)
    await this.page.mouse.move(x + offsetX, y + offsetY)
    return this._waitForAction()
  }

  /**
   * {{> focus }}