files/en-us/web/webdriver/reference/classic/commands/setwindowrect/index.md
The Set Window Rect command of the WebDriver API alters the size and position of the operating system window associated with the current window. The command acts as the setter of Get Window Rect, which return object you can pass directly as this command's payload.
Certain subsets of devices do not support setting the window dimensions or its position. On these configurations the command will return an unsupported operating error. To avoid running into situations where calling this might error it is possible to call it conditionally on whether the setWindowRect capability is set to true for the session.
Setting the window rect takes x, y, width, and height as input. All the fields are optional, e.g., the command may be called with an empty object, and in this case it will act as a no-op. To set the position both of x and y are required, and correspondingly both width and height are required for altering the window's dimensions.
When setting the width or height, it is not guaranteed that the resulting window size will exactly match that which was requested. The driver is expected to clamp values that are larger than the physical screen dimensions, or smaller than the minimum window size. Some drivers may also have other limitations such as not being able to resize in single-pixel increments. For this reason, the returned width and height might not exactly match Window.outerWidth and Window.outerHeight.
Setting the window's position is similar in nature to calling Window.moveTo(x, y), but differences itself by bypassing security restrictions related to window manipulation.
The Set Window Rect command is blocking.
| Method | URI template |
|---|---|
| POST | /session/{session id}/window/rect |
session id
The input is a WindowRect object:
x
window, which equivalent to Window.screenX. Must be a number in the −(2^31) to 2^31 − 1 range, null, or undefined.y
window, which is equivalent to Window.screenY. Must be a number in the −(2^31) to 2^31 − 1 range, null, or undefined.width
window, which is equivalent to Window.outerWidth. Must be a number in the 0 to 2^31 − 1 range, null, or undefined.height
window, which is equivalent to Window.outerHeight. Must be a number in the 0 to 2^31 − 1 range, null, or undefined.The response payload is a WindowRect:
x
window, equivalent to Window.screenX.y
window, equivalent to Window.screenY.width
window, equivalent to Window.outerWidth.height
window, equivalent to Window.outerHeight.WindowRect payload object do not meet the type or bounds constraints, or if only one of the x/y pair or width/height pair fields are specified.window has been closed.window.alert, blocks execution of command until it is dealt with.: If the driver does not support altering the window's size or position. This is usually the case on mobile devices, where the browser has a set dimension and cannot be moved around on the screen.
You can inspect the setWindowRect capability to tell if the device supports this command.
{{Specifications}}
{{Compat}}
WebWindow object