Selenium Java 调用 driver.manage().window().fullscreen() 后，页面加载或刷新会导致窗口自动退出全屏；本文详解原因并提供 maximize()、setSize() 等稳定替代方案及完整代码示例。
selenium java 调用 `driver.manage().window().fullscreen()` 后，页面加载或刷新会导致窗口自动退出全屏；本文详解原因并提供 `maximize()`、`setsize()` 等稳定替代方案及完整代码示例。
在 Selenium WebDriver 的 Java 实现中，driver.manage().window().fullscreen() 方法看似能将浏览器切换至系统级全屏模式（类似按 F11），但实际行为存在显著限制：该状态不具备持久性。一旦触发页面导航、刷新（如 driver.get()、driver.navigate().to() 或表单提交后重定向），Chrome 等主流浏览器会自动退出全屏，恢复为默认窗口尺寸——这并非 Selenium Bug，而是浏览器自身对全屏 API 的安全策略所致（全屏权限仅对当前文档生命周期有效，页面卸载即失效）。
因此，依赖 fullscreen() 实现“始终全屏”的自动化场景（如电子看板、演示测试、UI 一致性校验）不可靠。推荐采用以下两种稳定、跨浏览器兼容的替代方案：
✅ 方案一：使用 maximize()（推荐首选）
maximize() 将窗口最大化至操作系统桌面可用区域（排除任务栏/菜单栏），状态在页面跳转、刷新后自动保持，且兼容 Chrome、Firefox、Edge 等所有主流驱动：
WebDriver driver = new ChromeDriver();
driver.get("https://example.com");
driver.manage().window().maximize(); // 立即生效，且持久化
// 后续任何页面操作（如点击、跳转、刷新）均维持最大化
driver.navigate().refresh(); // 窗口仍为最大化状态
driver.get("https://another-site.com"); // 依然最大化⚠️ 注意：maximize() 不等于系统全屏（无地址栏/标签页），但对绝大多数 UI 测试、截图、响应式验证已完全足够，且稳定性远超 fullscreen()。
立即学习“Java免费学习笔记（深入）”；
✅ 方案二：使用 setSize() 精确控制窗口尺寸
若需严格匹配特定分辨率（如 1920×1080 全屏截图），可结合 Dimension 设置精确宽高。该设置同样在页面加载后持续有效：
import org.openqa.selenium.Dimension;
WebDriver driver = new ChromeDriver();
driver.get("https://example.com");
// 获取系统屏幕尺寸（可选：更精准适配）
Robot robot = new Robot();
Dimension screenSize = new Dimension(
(int) Toolkit.getDefaultToolkit().getScreenSize().getWidth(),
(int) Toolkit.getDefaultToolkit().getScreenSize().getHeight()
);
// 设置窗口为屏幕尺寸（模拟“真全屏”效果）
driver.manage().window().setSize(screenSize);
// 或指定固定尺寸：
// driver.manage().window().setSize(new Dimension(1920, 1080));
// 刷新或跳转后尺寸不变
driver.navigate().to("https://demoqa.com");
System.out.println("Current window size: " + driver.manage().window().getSize());
// 输出：Current window size: (1920, 1080)? 提示：使用 setSize() 前建议先调用 driver.manage().window().setPosition(new Point(0, 0)) 确保窗口位于左上角，避免被系统 UI（如 macOS 菜单栏）遮挡。
❌ 为什么不修复 fullscreen()？
Selenium 官方明确指出：fullscreen() 是对浏览器原生 document.documentElement.requestFullscreen() 的封装，其生命周期受 HTML5 Fullscreen API 规范约束——页面上下文销毁即退出全屏。试图通过 JavaScript 注入或监听 beforeunload 事件强行重置，不仅违反规范、增加不稳定性，且在无头模式（Headless）下完全无效。
总结与最佳实践
- 优先使用 maximize()：简洁、可靠、无需额外依赖，覆盖 95%+ 的测试场景；
- 需要像素级控制时选用 setSize() + setPosition()：适合视觉回归测试、多分辨率兼容验证；
- 避免在关键流程中依赖 fullscreen()：除非明确接受“单页有效”的限制（如仅用于启动后首屏展示）；
- 统一初始化窗口状态：建议在 @BeforeMethod 或 Driver 初始化阶段集中设置，确保每次测试起点一致。
通过合理选择 maximize() 或 setSize()，即可彻底规避 fullscreen() 的状态丢失问题，构建健壮、可维护的 Selenium 自动化脚本。
