Selenium Java Actions类点击/双击失效求助（点击触发未释放）

问题概述 #

使用Selenium Java的Actions类对指定元素执行点击或双击操作时，鼠标仅触发元素高亮状态，未完成完整的点击/双击动作，按钮功能未正常触发。

尝试的点击代码 #

WebElement refreshPreviewButton = driver.findElement(By.xpath("//div[@data-dojo-attach-point='_previewInTabBtn']"));
Actions action = new Actions(driver);
// 方案1
action.click(refreshPreviewButton).build().perform();

// 方案2
action.moveToElement(refreshPreviewButton).click().build().perform();

尝试的双击代码 #

WebElement refreshPreviewButton = driver.findElement(By.xpath("//div[@data-dojo-attach-point='_previewInTabBtn']"));
Actions action = new Actions(driver);

// 方案1
action.doubleClick(refreshPreviewButton).build().perform();

// 方案2
action.moveToElement(refreshPreviewButton).doubleClick().build().perform();

同页面其他元素可正常运行的代码 #

WebElement previewInTabButton = driver.findElement(By.xpath("//div[@data-dojo-attach-point='_previewInTabBtn']"));
Actions action = new Actions(driver);
action.doubleClick(previewInTabButton);
action.perform();

目标元素HTML结构 #

<div class="c3_axnPrvCHR2 c3_rows_nowrap c3_align_center c3_hidden" data-dojo-attach-point="_r2Cont">
   <div class="c3_axnPrvCBtns c3_axnPrvCBtnsL c3_rows_nowrap c3_align_center btn-sgmt-grp btn-group c3_br4 c3_bdr" data-dojo-attach-point="_btnsCont1">
      <div class="btn-sgmt c3_btn btn-icn-sq btn-icn-sq-34" title="preview" data-dojo-attach-point="_previewBtn">
         <svg class="c3i c3i_txt">
            <use class="c3i_u" xlink:href="#zi-eye-inactive"></use>
         </svg>
      </div>
      <div class="c3_bdr_r"></div>
      <div class="btn-sgmt c3_btn btn-icn-sq btn-icn-sq-34" title="code" data-dojo-attach-point="_codeBtn">
         <svg class="c3i c3i_txt">
            <use class="c3i_u" xlink:href="#zi-code"></use>
         </svg>
      </div>
   </div>
   <div class="c3_axnPrvCBtns c3_axnPrvCBtnsR c3_rows_nowrap c3_align_center c3_gpC16" data-dojo-attach-point="_btnsCont2">
      <div class="btn-default-outline2_new btn-sm c3_btn btn-fx" data-dojo-attach-point="_previewInTabBtn">
         <svg class="c3i c3i_txt">
            <use class="c3i_u" xlink:href="#zi-launch"></use>
         </svg>
         <div>Preview in tab</div>
      </div>
      <div class="btn-default-outline2_new btn-sm c3_btn btn-fx" data-dojo-attach-point="_refreshPreviewBtn">
         <div>Preview</div>
      </div>
   </div>
</div>

解决方案 #

1. 显式等待元素可点击 #

确保元素完全加载并处于可交互状态后再执行操作：

WebDriverWait wait = new WebDriverWait(driver, Duration.ofSeconds(10));
WebElement refreshPreviewButton = wait.until(ExpectedConditions.elementToBeClickable(By.xpath("//div[@data-dojo-attach-point='_refreshPreviewBtn']")));
Actions action = new Actions(driver);
action.click(refreshPreviewButton).perform();

2. 模拟完整点击动作（按下+释放） #

拆分点击动作，手动模拟鼠标按下和释放：

Actions action = new Actions(driver);
action.moveToElement(refreshPreviewButton)
      .clickAndHold()
      .release()
      .perform();

3. 使用JavaScript点击绕过Actions限制 #

如果Actions类模拟点击失效，直接执行JavaScript触发点击事件：

WebElement refreshPreviewButton = driver.findElement(By.xpath("//div[@data-dojo-attach-point='_refreshPreviewBtn']"));
JavascriptExecutor js = (JavascriptExecutor) driver;
js.executeScript("arguments[0].click();", refreshPreviewButton);

4. 检查元素是否被遮挡 #

确认目标元素未被弹窗、遮罩层等元素覆盖，可通过状态验证：

WebElement refreshPreviewButton = driver.findElement(By.xpath("//div[@data-dojo-attach-point='_refreshPreviewBtn']"));
if (refreshPreviewButton.isDisplayed() && refreshPreviewButton.isEnabled()) {
    Actions action = new Actions(driver);
    action.click(refreshPreviewButton).perform();
}

5. 调整Actions执行方式 #

尝试不使用build()，直接链式调用后执行：

Actions action = new Actions(driver);
action.moveToElement(refreshPreviewButton).click().perform();

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