设置窗口矩形

设置窗口矩形 命令 WebDriver API 更改与当前 window 关联的操作系统窗口的大小和位置。该命令充当获取窗口矩形的设置器，该设置器返回您可以直接作为此命令的有效负载传递的对象。

某些设备子集不支持设置窗口尺寸或其位置。在这些配置上，该命令将返回一个不支持的操作错误。为了避免遇到可能导致调用此命令时出错的情况，可以在 setWindowRect 功能是否为会话设置为 true 的情况下有条件地调用它。

设置窗口矩形需要 x、y、width 和 height 作为输入。所有字段都是可选的，例如，该命令可以调用一个空对象，在这种情况下，它将充当无操作。要设置位置，需要同时设置 x 和 y，相应地，要更改窗口的尺寸，需要同时设置 width 和 height。

在设置宽度或高度时，不能保证结果窗口大小会完全匹配请求的大小。驱动程序应钳制大于物理屏幕尺寸或小于最小窗口尺寸的值。某些驱动程序还可能存在其他限制，例如无法以单像素增量调整大小。因此，返回的 width 和 height 可能与 Window.outerWidth 和 Window.outerHeight 不完全匹配。

设置窗口位置类似于调用 Window.moveTo(x, y)，但通过绕过与窗口操作相关的安全限制而区别于自身。

设置窗口矩形命令是阻塞的。

语法

方法	URI 模板
POST	`/session/{session id}/window/rect`

URL 参数

会话 ID: 会话的标识符。

有效负载

输入是一个 WindowRect 对象

x: window 的水平位置，它等效于 Window.screenX。必须是 −(2^31) 到 2^31 − 1 范围内的数字、null 或 undefined。
y: window 的垂直位置，它等效于 Window.screenY。必须是 −(2^31) 到 2^31 − 1 范围内的数字、null 或 undefined。
宽度: window 的外宽度，它等效于 Window.outerWidth。必须是 0 到 2^31 − 1 范围内的数字、null 或 undefined。
高度: window 的外宽度，它等效于 Window.outerHeight。必须是 0 到 2^31 − 1 范围内的数字、null 或 undefined。