Selenium Java：如何定位页面内弹窗元素并验证弹窗是否打开

问题详情 #

测试https://www.boyner.com.tr/limon-t-shirt-911887页面时，点击“Beden Sihirbazı”按钮后弹窗正常弹出，但用以下代码验证弹窗状态时，出现元素找不到的错误：

public final By sizePage = By.xpath("//*[@class=\"text-h5 non-selectable text-center\"]");

// 检查弹窗是否打开
WebElement sizeSection = driver.findElement(sizePage);
boolean isOpened = sizeSection.isDisplayed();
boolean desiredBoolean = true;
Assert.assertEquals(isOpened, desiredBoolean);

报错截图：

可能的原因及解决办法 #

1. 未等待弹窗动态加载完成 #

弹窗属于动态渲染内容，代码执行速度快于弹窗加载，导致查找元素时目标元素尚未在DOM中出现。

解决代码：
使用显式等待确保元素可见后再进行操作：

WebDriverWait wait = new WebDriverWait(driver, Duration.ofSeconds(10));
WebElement sizeSection = wait.until(ExpectedConditions.visibilityOfElementLocated(sizePage));
Assert.assertTrue(sizeSection.isDisplayed());

2. 弹窗内容嵌套在iframe中 #

若弹窗的实际内容嵌入在iframe内，直接在主文档中查找元素会失败，需要先切换到对应的iframe上下文。

解决代码：

// 定位目标iframe（根据页面实际属性调整定位器）
WebElement sizeWizardIframe = driver.findElement(By.xpath("//iframe[contains(@src, 'size-wizard')]"));
// 切换到iframe
driver.switchTo().frame(sizeWizardIframe);

// 查找弹窗内元素并验证
WebElement sizeSection = driver.findElement(sizePage);
Assert.assertTrue(sizeSection.isDisplayed());

// 验证完成后切回主文档
driver.switchTo().defaultContent();

3. 定位器不够精准 #

当前XPath可能匹配到页面中其他相同class的元素，或者弹窗内元素的class存在动态变化（比如额外添加临时样式类）。

解决代码：
结合弹窗容器的唯一标识优化定位器，缩小查找范围：

// 假设弹窗容器有唯一class，比如"size-wizard-modal-container"
public final By sizePage = By.xpath("//div[contains(@class, 'size-wizard-modal-container')]//*[@class='text-h5 non-selectable text-center']");

4. 弹窗使用Shadow DOM封装 #

如果弹窗采用Shadow DOM技术隔离DOM结构，普通的Selenium定位方式无法穿透Shadow DOM获取内部元素。

解决代码：
通过JavaScript执行脚本获取Shadow DOM内的元素：

JavascriptExecutor jsExecutor = (JavascriptExecutor) driver;
// 定位Shadow DOM的宿主元素（根据页面实际属性调整）
WebElement shadowHost = driver.findElement(By.id("size-wizard-shadow-host"));
// 穿透Shadow DOM获取目标元素
WebElement sizeSection = (WebElement) jsExecutor.executeScript(
    "return arguments[0].shadowRoot.querySelector('.text-h5.non-selectable.text-center')", 
    shadowHost
);
Assert.assertTrue(sizeSection.isDisplayed());

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