Selenium点击地图Toggle Full Screen全屏切换按钮失效如何解决？

失效原因 #

• 谷歌地图控件为异步渲染元素，DOM初始加载完成后控件才会插入页面，未加等待逻辑直接查找会导致元素定位失败
• 类名匹配定位精准度不足，可能命中多个相似元素导致点击对象错误
• 页面嵌套独立谷歌地图iframe时，未切换iframe上下文直接查找主文档DOM，无法命中目标元素
• 无头模式运行时，浏览器默认禁用全屏API触发权限
• 浏览器驱动与浏览器版本不兼容，导致模拟点击事件未被控件识别

修复代码 #

基础通用修复方案（优先使用） #

// 导入必要依赖（未导入时需添加）
import org.openqa.selenium.support.ui.WebDriverWait;
import org.openqa.selenium.support.ui.ExpectedConditions;
import java.time.Duration;

// 显式等待10秒，用aria-label属性精准定位到可点击状态的元素
WebDriverWait wait = new WebDriverWait(driver, Duration.ofSeconds(10));
WebElement toggleFullscreen = wait.until(ExpectedConditions.elementToBeClickable(
    By.xpath("//button[@aria-label='Toggle fullscreen view']")
));

// 原生点击触发
toggleFullscreen.click();

嵌套iframe场景适配 #

如果地图是通过iframe嵌入主页面，需要先切换到iframe上下文再操作：

// 切换到地图iframe，定位方式可根据实际页面结构调整
driver.switchTo().frame(driver.findElement(By.cssSelector("iframe[src*='maps']")));

// 执行上述元素查找点击逻辑
// 操作完成后切回主文档
driver.switchTo().defaultContent();

JS点击优化写法 #

原生点击失效时可替换为该写法，避免元素引用传递异常：

JavascriptExecutor executor = (JavascriptExecutor) driver;
executor.executeScript("document.querySelector('button.gm-fullscreen-control').click();");

无头模式适配 #

使用无头Chrome运行时，需要添加启动参数支持全屏：

ChromeOptions options = new ChromeOptions();
options.addArguments("--start-fullscreen");
options.addArguments("--allow-fullscreen");
// 其余启动配置省略
WebDriver driver = new ChromeDriver(options);

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