如何在同一段Karate脚本中从Java Selenium WebDriver切换至Karate Driver

核心问题是：直接通过Java代码操作Selenium WebDriver切换窗口后，Karate的Driver内部维护的窗口上下文没有同步，导致后续Karate API无法正确识别当前窗口。可以通过以下两种方式解决：

方法1：在Java处理逻辑中切回原窗口，再同步Karate Driver #

步骤1：修改Java的PopupHandler类，处理完弹窗后切回原窗口 #

package com.example;
import com.intuit.karate.driver.Driver;
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;

public class PopupHandler {
    public static void handlePopup(Driver karateDriver) {
        // 获取Karate Driver对应的Selenium WebDriver实例
        WebDriver seleniumDriver = (WebDriver) karateDriver.getDelegate();
        
        // 记录原窗口句柄
        String originalWindow = seleniumDriver.getWindowHandle();
        
        // 遍历所有窗口，找到弹窗并处理
        for (String windowHandle : seleniumDriver.getWindowHandles()) {
            seleniumDriver.switchTo().window(windowHandle);
            // 这里根据实际弹窗的特征判断，比如标题、URL
            if (seleniumDriver.getTitle().contains("弹窗专属标题")) {
                // 执行弹窗处理逻辑，比如关闭弹窗
                seleniumDriver.findElement(By.id("popup-close-btn")).click();
                break;
            }
        }
        
        // 切回原窗口
        seleniumDriver.switchTo().window(originalWindow);
    }
}

步骤2：在Karate脚本中调用后同步Driver #

调用Java方法后，执行driver.sync()让Karate Driver同步当前窗口的上下文：

Given driver 'https://www.example.com'
When driver.click('button#popupButton')
And Java.call(PopupHandler.handlePopup, driver)
# 同步Karate Driver到当前活动窗口
And driver.sync()
# 后续正常使用Karate Driver执行操作
Then driver.click('button#main-page-btn')

方法2：从Java返回原窗口句柄，在Karate中手动切换 #

步骤1：修改Java方法返回原窗口句柄 #

package com.example;
import com.intuit.karate.driver.Driver;
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;

public class PopupHandler {
    public static String handlePopup(Driver karateDriver) {
        WebDriver seleniumDriver = (WebDriver) karateDriver.getDelegate();
        String originalWindow = seleniumDriver.getWindowHandle();
        
        // 弹窗处理逻辑...
        for (String windowHandle : seleniumDriver.getWindowHandles()) {
            seleniumDriver.switchTo().window(windowHandle);
            if (seleniumDriver.getCurrentUrl().contains("popup-url")) {
                seleniumDriver.findElement(By.className("close")).click();
                break;
            }
        }
        
        return originalWindow;
    }
}

步骤2：在Karate中用返回的句柄切换窗口 #

Given driver 'https://www.example.com'
When driver.click('button#popupButton')
* def originalWindow = Java.call(PopupHandler.handlePopup, driver)
# 手动切换回原窗口，让Karate Driver绑定到该窗口
* driver.window(originalWindow)
# 继续执行后续测试步骤
Then driver.assertUrl('https://www.example.com/main')

原理说明：Karate的Driver对Selenium WebDriver做了封装，内部会维护当前窗口的状态缓存。当直接操作底层的Selenium WebDriver切换窗口后，Karate的缓存状态没有更新，所以需要通过driver.sync()自动同步，或者driver.window(handle)手动指定窗口，让Karate Driver重新关联到正确的窗口上下文。

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