Selenium WebDriver获取Tooltip标题失败问题求助

问题场景 #

测试页面中，鼠标悬停在「Print」选项上会显示Tooltip，标题文本为「Natural」或「Fresh」，但调用getStyleTooltip()时返回空字符串。

问题原因 #

1. 元素缓存导致状态不一致：@CacheLookup注解会缓存元素的初始状态，此时Tooltip尚未显示，元素文本为空，后续调用仍获取缓存的空值。
2. 缺少显式等待：悬停后Tooltip需要时间渲染，直接获取文本时元素可能还未加载完成。
3. 定位器精度不足：通用的div[class='tooltip-header']可能匹配到页面中其他隐藏的同类型元素，返回空文本。

解决办法 #

1. 移除@CacheLookup注解

Tooltip是动态显示的元素，缓存初始状态会导致无法获取更新后的文本：

// 移除@CacheLookup注解
@FindBy(css = "div[class='tooltip-header']")
WebElement tooltipHeader;

2. 添加显式等待确保元素可见

在获取文本前，等待Tooltip元素完全可见，保证文本已加载：

public String getStyleTooltip() {
    WebDriverWait wait = new WebDriverWait(driver, Duration.ofSeconds(10));
    // 等待Tooltip可见后再获取文本
    WebElement visibleTooltip = wait.until(ExpectedConditions.visibilityOf(tooltipHeader));
    return visibleTooltip.getText();
}

3. 使用精准定位器关联目标元素

如果页面存在多个同类型Tooltip，可基于当前悬停的「Print」元素定位对应的Tooltip，避免匹配错误：

// 修改moveToStyle方法，返回当前操作的Style元素
public WebElement moveToStyle(int index) {
    WebElement styleElement = driver.findElement(By.xpath("//*[@id='image-squares-8']/li[" + index + "]/div"));
    Actions actions = new Actions(driver);
    actions.moveToElement(styleElement).perform();
    return styleElement;
}

// 基于Style元素获取对应的Tooltip文本
public String getStyleTooltip(WebElement styleElement) {
    WebDriverWait wait = new WebDriverWait(driver, Duration.ofSeconds(10));
    WebElement tooltip = wait.until(ExpectedConditions.visibilityOf(
        styleElement.findElement(By.xpath("./div[1]"))
    ));
    return tooltip.getText();
}

// 调用方式调整
WebElement targetStyle = mainPage.moveToApparel()
        .select()
        .selectNthProductOnPage(1)
        .selectSize(8)
        .selectColor("White/Black")
        .moveToStyle(1);
String text = mainPage.getStyleTooltip(targetStyle);

额外注意事项 #

• 确保Actions类的moveToElement方法执行完成后再获取Tooltip，优先使用显式等待而非强制休眠（如Thread.sleep()）。
• 检查页面是否有动态加载的CSS或JS影响Tooltip显示，确保悬停动作触发了Tooltip的显示逻辑。

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