Selenium 4启用BiDi后，如何兼容原有对话框处理逻辑？

启用Selenium 4的BiDi功能（通过options.setCapability("webSocketUrl", true)）后，原有driver.switchTo().alert()方法会失效，Alert、Modal和Prompt无法正常交互。虽然通过DevTools添加监听器可以解决，但需要大幅修改现有测试脚本，例如这段示例代码：

DevTools devTools = ((ChromeDriver) webDriver).getDevTools();
devTools.createSession();

// Listen for JavaScript dialogs (alerts, confirms, prompts)
devTools.send(Page.enable());
devTools.addListener(Page.javascriptDialogOpening(), dialog -> {
  System.out.println("Alert Text: " + dialog.getMessage());
  devTools.send(Page.handleJavaScriptDialog(true, null)); // Accept the alert
});

以下是几种更轻量化的解决方案：

方案1：按需启用BiDi，避免全局配置 #

如果测试不是全程依赖BiDi功能，可仅在需要使用BiDi的代码段中临时启用webSocketUrl能力，完成操作后恢复原有配置重新创建普通驱动：

// 保存原有配置状态
Boolean originalWebSocketFlag = (Boolean) options.getCapability("webSocketUrl");
if (originalWebSocketFlag == null) originalWebSocketFlag = false;

// 临时创建BiDi驱动执行特定操作
options.setCapability("webSocketUrl", true);
WebDriver biDiDriver = new ChromeDriver(options);
// 执行需要BiDi的操作
// ...
biDiDriver.quit();

// 恢复配置，创建普通驱动处理Alert
options.setCapability("webSocketUrl", originalWebSocketFlag);
WebDriver normalDriver = new ChromeDriver(options);
normalDriver.switchTo().alert().accept();

方案2：封装Alert处理为通用工具类 #

将DevTools监听器逻辑封装成全局工具类，只需在测试初始化时调用一次，无需在每个脚本中重复编写：

import org.openqa.selenium.chrome.ChromeDriver;
import org.openqa.selenium.devtools.DevTools;
import org.openqa.selenium.devtools.v125.page.Page;

public class BiDiAlertHelper {
    public static void autoHandleAlerts(ChromeDriver driver) {
        DevTools devTools = driver.getDevTools();
        devTools.createSessionIfNotExists();
        devTools.send(Page.enable());
        devTools.addListener(Page.javascriptDialogOpening(), dialog -> {
            // 可自定义处理逻辑：记录日志、输入prompt内容等
            devTools.send(Page.handleJavaScriptDialog(true, null));
        });
    }
}

使用时只需在驱动初始化后执行BiDiAlertHelper.autoHandleAlerts((ChromeDriver) driver);，后续所有Alert会自动处理。

方案3：使用Selenium 4.10+原生BiDi Dialog API #

Selenium 4.10及以上版本提供了更简洁的BiDi Dialog处理API，替代复杂的DevTools操作，语法更贴近原生Selenium用法：

import org.openqa.selenium.bidi.browser.Dialog;
import org.openqa.selenium.bidi.HasBiDi;
import org.openqa.selenium.bidi.browser.DialogEvent;

// 获取BiDi会话
var bidiSession = ((HasBiDi) driver).getBiDi();

// 注册Dialog监听器
bidiSession.addListener(new DialogEvent() {
    @Override
    public void onDialog(Dialog dialog) {
        // 根据需求选择接受、拒绝或输入内容
        dialog.accept();
        // dialog.dismiss();
        // dialog.sendKeys("prompt input content");
    }
});

该API无需手动启用Page域，代码更简洁，改动量远小于直接操作DevTools。

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