如何跨类调用Selenium FluentWait并避免Thread.sleep

我在做Selenium自动化测试时，需要等待指定元素加载完成或变为可点击状态，于是用FluentWait替代Thread.sleep。为了避免代码重复，写了封装FluentWait方法的FluentHelper类，在测试脚本里调用这个方法。但遇到问题：脚本里直接写FluentWait逻辑能正常工作，调用外部类方法时却没法正常点击元素，必须加Thread.sleep才能操作nextButton，想找不用Thread.sleep的解决办法。

相关代码 #

FluentHelper类代码 #

package Athlete;

import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.support.ui.ExpectedCondition;
import org.openqa.selenium.support.ui.FluentWait;
import org.openqa.selenium.support.ui.Wait;

import java.time.Duration;

public class FluentHelper {

    public static WebElement waitForElement(WebDriver driver, By by, int timeoutSeconds, int pollingIntervalMillis) {
        Wait<WebDriver> wait = new FluentWait<>(driver)
                .withTimeout(Duration.ofSeconds(timeoutSeconds))
                .pollingEvery(Duration.ofMillis(pollingIntervalMillis))
                .ignoring(Exception.class);

        return wait.until((ExpectedCondition<WebElement>) webDriver -> webDriver.findElement(by));
    }
}

测试脚本eSignReportCreate代码 #

package Athlete;

import java.time.Duration;
import java.util.Properties;
import org.openqa.selenium.By;
import org.openqa.selenium.ElementNotInteractableException;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.chrome.ChromeDriver;
import org.openqa.selenium.support.ui.ExpectedConditions;
import org.openqa.selenium.support.ui.FluentWait;
import org.openqa.selenium.support.ui.WebDriverWait;


public class eSignReportCreate {

    public static void main(String[] args) {
        try {
            WebDriver driver = new ChromeDriver();
            ApiRequest apiRequest = new ApiRequest();
            Properties configProperties = ConfigReader.getConfigProperties();
            
            //FluentWaitHelper waitHelper = new FluentWaitHelper(driver, 30, 1000);
                       
            String webUrl = configProperties.getProperty("webUrl");
            String token = apiRequest.getTokenFromApi();
            String eImzaPassword = configProperties.getProperty("eImzaKey");
            String idNumber = IdEnum.ID_NUMBER_1.getIdNumber();
            // Initialize your Selenium WebDriver (Make sure you have the necessary WebDriver executable)
           // System.setProperty("webdriver.chrome.driver", "path/to/chromedriver"); // Specify the path to chromedriver
            
            driver.manage().window().maximize();
            driver.get(webUrl + token);             
            driver.findElement(By.linkText("Kapat")).click();
            driver.findElement(By.xpath("//a[@class='ob-click-me k-button' and contains(text(),'Yeni Kayıt')]")).click();
            driver.findElement(By.linkText("Kapat")).click();
            driver.findElement(By.name("IdentityNumber")).sendKeys(idNumber);
            driver.findElement(By.id("sorgulabtn")).click();

//            FluentWait<WebDriver> wait = new FluentWait<>(driver)
//                  .withTimeout(Duration.ofSeconds(30))
//                  .pollingEvery(Duration.ofMillis(300))
//                  .ignoring(ElementNotInteractableException.class);
//
//              wait.until(d -> {
//                  WebElement nextButton = driver.findElement(By.id("nextBtn"));
//                  if (nextButton.isDisplayed() && nextButton.isEnabled()) {
//                      nextButton.click();
//                      return true;
//                  }
//                  return false;
//              });
            WebElement nextButton = FluentHelper.waitForElement(driver, By.id("nextBtn"), 20, 1000);
            Thread.sleep(5000);
            nextButton.click();

问题原因 #

你当前封装的waitForElement方法只等待元素存在于DOM中（能通过findElement找到），但元素存在不代表它已经可见、可交互。而你直接写的FluentWait逻辑里，额外判断了isDisplayed()和isEnabled()，直到元素满足这两个条件才执行点击，所以能正常工作。封装方法缺少这些判断，导致返回的元素可能还没准备好被点击。

解决方案 #

方案1：修改现有方法，等待元素可点击 #

直接修改waitForElement方法，让它等待元素达到可点击状态，同时只忽略必要的Selenium异常，避免掩盖其他错误：

package Athlete;

import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.support.ui.ExpectedConditions;
import org.openqa.selenium.support.ui.FluentWait;
import org.openqa.selenium.support.ui.Wait;

import java.time.Duration;

public class FluentHelper {

    public static WebElement waitForElement(WebDriver driver, By by, int timeoutSeconds, int pollingIntervalMillis) {
        Wait<WebDriver> wait = new FluentWait<>(driver)
                .withTimeout(Duration.ofSeconds(timeoutSeconds))
                .pollingEvery(Duration.ofMillis(pollingIntervalMillis))
                .ignoring(org.openqa.selenium.NoSuchElementException.class)
                .ignoring(org.openqa.selenium.ElementNotInteractableException.class);

        return wait.until(ExpectedConditions.elementToBeClickable(by));
    }
}

方案2：封装多种等待方法（更灵活） #

如果测试中需要不同的等待场景（比如只需要元素可见，不需要可点击），可以封装多个针对性的方法：

package Athlete;

import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.support.ui.ExpectedConditions;
import org.openqa.selenium.support.ui.FluentWait;
import org.openqa.selenium.support.ui.Wait;

import java.time.Duration;

public class FluentHelper {

    // 等待元素存在于DOM中
    public static WebElement waitForElementExists(WebDriver driver, By by, int timeoutSeconds, int pollingIntervalMillis) {
        Wait<WebDriver> wait = new FluentWait<>(driver)
                .withTimeout(Duration.ofSeconds(timeoutSeconds))
                .pollingEvery(Duration.ofMillis(pollingIntervalMillis))
                .ignoring(org.openqa.selenium.NoSuchElementException.class);

        return wait.until(ExpectedConditions.presenceOfElementLocated(by));
    }

    // 等待元素可见
    public static WebElement waitForElementVisible(WebDriver driver, By by, int timeoutSeconds, int pollingIntervalMillis) {
        Wait<WebDriver> wait = new FluentWait<>(driver)
                .withTimeout(Duration.ofSeconds(timeoutSeconds))
                .pollingEvery(Duration.ofMillis(pollingIntervalMillis))
                .ignoring(org.openqa.selenium.NoSuchElementException.class)
                .ignoring(org.openqa.selenium.ElementNotVisibleException.class);

        return wait.until(ExpectedConditions.visibilityOfElementLocated(by));
    }

    // 等待元素可点击（推荐用于点击操作场景）
    public static WebElement waitForElementClickable(WebDriver driver, By by, int timeoutSeconds, int pollingIntervalMillis) {
        Wait<WebDriver> wait = new FluentWait<>(driver)
                .withTimeout(Duration.ofSeconds(timeoutSeconds))
                .pollingEvery(Duration.ofMillis(pollingIntervalMillis))
                .ignoring(org.openqa.selenium.NoSuchElementException.class)
                .ignoring(org.openqa.selenium.ElementNotInteractableException.class);

        return wait.until(ExpectedConditions.elementToBeClickable(by));
    }
}

之后在测试脚本中调用对应的方法即可，无需再添加Thread.sleep：

// 调用等待可点击的方法
WebElement nextButton = FluentHelper.waitForElementClickable(driver, By.id("nextBtn"), 20, 1000);
nextButton.click();

额外提示 #

• 不要用ignoring(Exception.class)忽略所有异常，应该只忽略Selenium特定的异常（比如找不到元素、元素不可交互），否则会掩盖代码中的其他错误。
• 尽量使用Selenium内置的ExpectedConditions类，里面封装了各种常用的等待条件，比自己写判断逻辑更可靠。

内容的提问来源于stack exchange，提问作者şamil canbolat