本地与Selenium Grid中WebDriver处理新窗口的差异问题

问题描述 #

使用Selenium+Java搭配兼容IE模式的Edge浏览器（依赖IEDriverServer），点击带有target="_blank"的链接元素后会打开新窗口。本地环境中driver.getWindowHandles()能获取到2个窗口句柄，但在Selenium Grid远程环境中仅能获取原窗口句柄，无法定位新窗口内的元素。本地与Grid环境的IEDriverServer配置完全一致，仅运行环境不同，怀疑远程环境中新窗口可能在Grid机器与显示机器分属不同设备。

版本信息 #

• Edge: Version 116.0.1938.54 (官方版本) 64位
• IEDriverServer: 4.10.0.0

代码示例 #

String xp = "//a[@id='iframe_DocList']";
WebElement view = driver.findElement(By.xpath(xp));
// 校验元素存在
view.click();
try {
       Thread.sleep(10000);
} catch (InterruptedException e) {

}

// 本地环境此处能获取2个窗口，Grid环境仅1个
boolean found = false;
for (int i = 0; i < 2 && !found; i++) {
   for (String d : driver.getWindowHandles()) {
       driver.switchTo().window(d);
       // 新窗口内存在id为DocSelectPage的iframe
       if (driver.findElements(By.xpath("//iframe[@id='DocSelectPage']")).size() !=0) {
           found = true;
           break;
       }
   }
}

目标元素HTML片段 #

<td>
    <a onclick="return onclick_DocType();" id="iframe_DocList" 
       class="fauxButton" style="WIDTH: 108px; 
       PADDING-BOTTOM: 2px; PADDING-TOP: 2px; PADDING-LEFT: 8px; 
       PADDING-RIGHT: 8px" href="" target="_blank">View Documents</a>
</td>

解决办法 #

1. 调整IEDriverServer配置参数 #

IE模式下的Edge在Grid环境中，新窗口可能无法与原Driver实例自动关联，需添加以下配置：

InternetExplorerOptions options = new InternetExplorerOptions();
options.attachToEdgeChrome();
// 指定Grid节点上Edge可执行文件的实际路径
options.withEdgeExecutablePath("C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe");
// 禁用原生事件，避免窗口关联失败
options.setCapability("nativeEvents", false);
// 强制获取窗口焦点，确保新窗口被Driver捕获
options.setCapability("requireWindowFocus", true);
// 禁用IE保护模式检查（需确保Grid节点浏览器设置一致）
options.setCapability("ignoreProtectedModeSettings", true);

// 连接Grid节点
WebDriver driver = new RemoteWebDriver(new URL("http://your-grid-hub:4444/wd/hub"), options);

2. 替换固定等待为显式等待 #

本地的固定延迟在远程环境中可能不足以等待新窗口加载，改用显式等待监听窗口数量变化：

String originalWindow = driver.getWindowHandle();
view.click();

// 等待窗口数量变为2，超时15秒
new WebDriverWait(driver, Duration.ofSeconds(15)).until(
    driver -> driver.getWindowHandles().size() == 2
);

// 切换到新窗口
for (String windowHandle : driver.getWindowHandles()) {
    if (!originalWindow.equals(windowHandle)) {
        driver.switchTo().window(windowHandle);
        break;
    }
}

// 等待目标iframe加载完成
new WebDriverWait(driver, Duration.ofSeconds(10)).until(
    ExpectedConditions.presenceOfElementLocated(By.id("DocSelectPage"))
);

3. 配置Grid节点的浏览器环境 #

• 确保Grid节点上的Edge浏览器已正确配置IE模式，将目标站点添加到IE兼容站点列表
• 统一IE浏览器所有区域的保护模式设置（全部启用或全部禁用）
• 以交互式用户身份启动Grid节点服务，避免浏览器在后台会话中运行导致窗口无法被捕获

4. 检查版本兼容性 #

确认IEDriverServer版本（4.10.0.0）与Edge版本（116.x）兼容，若存在版本不匹配，升级IEDriverServer至对应大版本的匹配版本

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