Selenium WebDriverJs元素不可点击错误的重试处理方法咨询

我之前做类似的Google搜索自动化时也踩过这个坑——Google的搜索按钮(btnK)有时候会因为自动补全弹窗遮挡、元素渲染延迟，导致直接点击触发ElementClickInterceptedError或者ElementNotInteractableError。下面给你两个实用的解决办法：

方法一：用Selenium原生的可点击等待条件（最推荐） #

Selenium WebDriverJS内置了until.elementIsClickable条件，它会自动等待元素存在于DOM中、可见、并且可点击，完全不用自己写重试逻辑。修改后的代码如下：

const {Builder, By, until} = require('selenium-webdriver');

(async function example() {
  let driver = await new Builder()
    .forBrowser('firefox')
    .build();
  try {
    await driver.get('http://www.google.com/ncr');
    // 先等待搜索框可输入，输入关键词
    await driver.wait(until.elementLocated(By.name('q')), 5000);
    await driver.findElement(By.name('q')).sendKeys('webdriver');
    
    // 重点：等待搜索按钮可点击后再执行点击
    const searchBtn = await driver.wait(until.elementIsClickable(By.name('btnK')), 5000);
    await searchBtn.click();
    
    await driver.wait(until.titleIs('webdriver - Google Search'), 1000);
  } finally {
    await driver.quit();
  }
})();

为什么这个方法有效？ #

原来的代码只用findElement找到元素就点击，但findElement只保证元素存在于DOM中，不代表它已经渲染完成、没有被遮挡。elementIsClickable会持续检查元素状态，直到满足条件或者超时，完美解决加载延迟的问题。

方法二：自定义点击重试函数（应对特殊场景） #

如果遇到一些极端情况（比如元素短暂不可点击，原生等待也偶尔失效），可以写一个自定义的重试函数，捕获点击错误并重复尝试。示例代码如下：

const {Builder, By, until, error} = require('selenium-webdriver');

// 自定义重试点击函数
async function retryClick(driver, locator, maxRetries = 3, delay = 1000) {
  let attempts = 0;
  while (attempts < maxRetries) {
    try {
      const element = await driver.findElement(locator);
      await element.click();
      return; // 点击成功，退出函数
    } catch (err) {
      // 只捕获点击相关的错误，其他错误直接抛出
      if (err instanceof error.ElementClickInterceptedError || 
          err instanceof error.ElementNotInteractableError) {
        attempts++;
        if (attempts === maxRetries) throw err; // 达到重试次数，抛出错误
        await driver.sleep(delay); // 等待一段时间后重试
      } else {
        throw err;
      }
    }
  }
}

(async function example() {
  let driver = await new Builder()
    .forBrowser('firefox')
    .build();
  try {
    await driver.get('http://www.google.com/ncr');
    await driver.wait(until.elementLocated(By.name('q')), 5000);
    await driver.findElement(By.name('q')).sendKeys('webdriver');
    
    // 使用自定义重试函数点击按钮
    await retryClick(driver, By.name('btnK'), 3, 1000);
    
    await driver.wait(until.titleIs('webdriver - Google Search'), 1000);
  } finally {
    await driver.quit();
  }
})();

这个方法的优势： #

可以精准控制重试次数和间隔时间，针对那些偶尔出现的点击失败场景，比原生等待更灵活。需要注意的是，不要把重试次数设得太高，避免无限等待。

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