Selenium WebDriver触发XPath元素hover事件的问题与解决方案

问题1：XPath定位元素触发hover时语法报错 #

原代码：

((JavascriptExecutor) driver).executeScript("$('(//span[@class='attribute-square-container'])[2]').hover();");

报错：

org.openqa.selenium.JavascriptException: SyntaxError: missing ) after argument list

问题原因 #

1. jQuery的$()默认仅支持CSS选择器，不直接兼容XPath语法，直接传入XPath会导致解析逻辑错误。
2. 引号嵌套冲突：XPath中的'attribute-square-container'使用单引号，外层包裹脚本的也是单引号，导致JS解析时提前截断字符串，出现括号不匹配的语法错误。

修正思路 #

• 若要使用XPath，可改用原生JS的document.evaluate()或jQuery的$x()方法（需环境支持）；
• 更稳妥的方式是将XPath转换为等价的CSS选择器，比如把原XPath转为span.attribute-square-container:nth-of-type(2)，再配合事件触发逻辑修改代码。

问题2：修改后无报错但hover效果不生效 #

修改后代码：

String script = "$(`#image-squares-8 > li:nth-child(2) > label > span > span`).hover();";
((JavascriptExecutor) driver).executeScript(script);

问题原因 #

jQuery的.hover()方法本质是绑定mouseenter和mouseleave事件的处理函数，而非直接触发元素的hover状态。如果仅需触发hover以显示tooltip，应该直接模拟鼠标进入事件。

修正代码 #

String script = "$('#image-squares-8 > li:nth-child(2) > label > span > span').trigger('mouseenter');";
((JavascriptExecutor) driver).executeScript(script);

问题3：Firefox中使用Actions触发hover时出现边界溢出错误 #

报错：

org.openqa.selenium.interactions.MoveTargetOutOfBoundsException: Move target (807, 750) is out of bounds of viewport dimensions (1536, 731)

问题原因 #

Firefox的Actions类执行moveToElement时，要求目标元素必须处于当前视口范围内，否则会抛出边界溢出异常；而Chrome会自动将元素滚动至视口，因此能正常执行。

兼容Firefox的通用解决方案 #

以下代码可同时兼容Chrome和Firefox，先确保元素进入视口后再触发hover：

public void moveToElement(WebElement element) {
    Capabilities cap = ((RemoteWebDriver) driver).getCapabilities();

    if(cap.getBrowserName().startsWith("firefox")) {
        ((JavascriptExecutor) driver).executeScript("arguments[0].scrollIntoView(true);", element);
    }

    Actions action = new Actions(driver);
    action.moveToElement(element).perform();
}

内容的提问来源于stack exchange，提问作者fotrenc