Method clickXY

lib/helper/WebDriver.js:1180–1229

* Performs click at specific coordinates. * If locator is provided, the coordinates are relative to the element's top-left corner. * If locator is not provided, the coordinates are relative to the body element. * * ```js * // Click at coordinates (100, 200) relative to body * I.cli

(locator, x, y)

   * @returns {Promise<void>}
   */
  async clickXY(locator, x, y) {
    // If locator is a number, treat it as X coordinate and use body as base
    if (typeof locator === 'number') {
      const globalX = locator
      const globalY = x
      locator = '//body'
      x = globalX
      y = globalY
    }

    // Locate the base element
    const res = await this._locate(withStrictLocator(locator), true)
    assertElementExists(res, locator, 'Element to click')
    const el = usingFirstElement(res)

    // Get element position and size to calculate top-left corner
    const location = await el.getLocation()
    const size = await el.getSize()

    // WebDriver clicks at center by default, so we need to offset from center to top-left
    // then add our desired x, y coordinates
    const offsetX = -(size.width / 2) + x
    const offsetY = -(size.height / 2) + y

    if (this.browser.isW3C) {
      // Use performActions for W3C WebDriver
      return this.browser.performActions([
        {
          type: 'pointer',
          id: 'pointer1',
          parameters: { pointerType: 'mouse' },
          actions: [
            {
              type: 'pointerMove',
              origin: el,
              duration: 0,
              x: Math.round(offsetX),
              y: Math.round(offsetY),
            },
            { type: 'pointerDown', button: 0 },
            { type: 'pointerUp', button: 0 },
          ],
        },
      ])
    }

    // Fallback for non-W3C browsers
    await el.moveTo({ xOffset: Math.round(offsetX), yOffset: Math.round(offsetY) })
    return el.click()
  }

  /**
   * {{> forceRightClick }}