Selenium-Java与WebDriverManager多标签页录屏问题咨询

核心问题解答 #

• 是否支持多标签页同时录屏？
  WebDriverManager的标签页录屏依赖Chrome DevTools Protocol（CDP）的StartRecording指令实现，而CDP录屏会话是绑定单个标签页上下文的。你看到两个标签页都显示录屏图标，但后续启动的会话会覆盖前一个，导致仅生成第一个标签页的录屏文件。原生不支持同时录制多个标签页。

• 能否生成单个视频或多标签对应多个视频？

  • 单个视频文件：原生CDP录屏无法实现，因为每个标签页的录屏是独立会话，无法合并到同一视频流。
  • 多标签对应多个视频：可行，但需要严格管理每个标签页的录屏会话，避免冲突。

替代实现方案 #

方案1：优化标签页切换时的录屏启停逻辑 #

你提到的切换标签页时启停录屏是可行的，可以封装工具类实现自动管理：

• 维护当前活跃标签页的录屏会话ID和文件路径映射
• 在切换标签页前自动停止当前录屏，切换后启动新标签页的录屏
• 示例代码片段：

public class TabScreenRecorder {
    private DevTools devTools;
    private String activeWindowHandle;
    private final Map<String, String> windowToFileMap = new HashMap<>();

    public void init(ChromeDriver driver) {
        devTools = driver.getDevTools();
        devTools.createSession();
    }

    public void start(String windowHandle, String outputPath) {
        activeWindowHandle = windowHandle;
        windowToFileMap.put(windowHandle, outputPath);
        devTools.send(Page.startRecording(new Page.StartRecording()
                .setCaptureBeyondViewport(true)
                .setVideoName(outputPath)));
    }

    public void stopCurrent() {
        if (activeWindowHandle == null) return;
        byte[] videoData = devTools.send(Page.stopRecording());
        try {
            Files.write(Paths.get(windowToFileMap.get(activeWindowHandle)), videoData);
        } catch (IOException e) {
            e.printStackTrace();
        }
        activeWindowHandle = null;
    }

    public void switchAndRecord(WebDriver driver, String targetHandle, String targetPath) {
        stopCurrent();
        driver.switchTo().window(targetHandle);
        start(targetHandle, targetPath);
    }
}

方案2：录制整个浏览器窗口（替代标签页录屏） #

如果不需要区分单个标签页的操作，而是要捕获整个测试流程，改用系统级录屏工具更简单：

• 调用Windows的ffmpeg/screenrecorder.exe、macOS的screencapture/ffmpeg、Linux的ffmpeg/recordmydesktop
• 在测试用例的@BeforeMethod和@AfterMethod中封装启动/停止逻辑
• 优势：生成单个视频文件，覆盖所有标签页操作，无需管理CDP会话
• 注意：确保测试机器安装对应工具并配置环境变量

方案3：Selenium Grid录屏（分布式测试场景） #

如果测试基于Selenium Grid运行，可启用Grid自带的录屏功能：

• 在节点配置文件中开启video扩展，指定存储路径
• Grid会自动录制整个测试会话的浏览器窗口操作，生成单个视频
• 节点配置示例（nodeConfig.json）：

{
  "capabilities": [
    {
      "browserName": "chrome",
      "goog:chromeOptions": {},
      "video": {
        "enabled": true,
        "videoPath": "./test-videos/",
        "deleteOnSuccess": false
      }
    }
  ]
}

总结 #

• WebDriverManager原生标签页录屏不支持多标签同时录制，切换启停是区分单标签操作的可行方案，优化后可自动管理会话
• 若需要单个视频文件，优先选择系统级录屏或Selenium Grid录屏方案

内容的提问来源于stack exchange，提问作者nunooliveira-vakt