在go-rod项目中正确设置设备视口方向的方法

在使用go-rod进行浏览器自动化测试时，开发者可能会遇到设备视口方向设置的问题。本文将通过一个实际案例，详细介绍如何正确设置设备的视口方向。

问题背景

当使用go-rod的DefaultDevice方法设置默认设备为devices.LaptopWithHiDPIScreen时，开发者发现视口的宽度和高度值出现了反转。具体表现为：

• 预期结果：window.innerWidth为1440，window.innerHeight为900
• 实际结果：视口尺寸显示为相反的值

设备定义分析

查看devices.LaptopWithHiDPIScreen的原始定义，可以看到它包含了水平和垂直两种方向的屏幕尺寸配置：

LaptopWithHiDPIScreen = Device{
    Title:          "Laptop with HiDPI screen",
    Screen: Screen{
        DevicePixelRatio: 2,
        Horizontal: ScreenSize{
            Width:  1440,
            Height: 900,
        },
        Vertical: ScreenSize{
            Width:  900,
            Height: 1440,
        },
    },
}

解决方案

go-rod提供了.Landscape()方法来明确指定使用水平方向的屏幕尺寸。正确的使用方式应该是：

browser := rod.New().ControlURL(url).DefaultDevice(devices.LaptopWithHiDPIScreen.Landscape())

技术原理

1. 设备方向处理：go-rod的设备定义支持多种方向配置，默认情况下可能不会自动选择水平方向
2. Landscape方法：明确告诉浏览器使用水平方向的屏幕尺寸配置
3. 视口设置：这种方法确保了视口尺寸与预期一致，避免了自动选择可能带来的方向错误

最佳实践

1. 当需要特定方向的视口时，总是明确指定.Landscape()或.Portrait()
2. 在定义自定义设备时，考虑同时提供水平和垂直方向的尺寸配置
3. 测试时验证实际的视口尺寸是否符合预期

通过这种方式，开发者可以精确控制浏览器模拟设备的视口方向，确保自动化测试的稳定性和准确性。