webdriver command
Get Window Rect
The Get Window Rect command of the WebDriver API returns the size and position of the given WebElement. Many WebDriver clients present separate API methods for getting an element’s location and dimensions, but as an optimization they both use this primitive.
The command operates on the currently selected window, and returns size and position of the operating system window. The returned WindowRect can be used as input for the Set Window Rect command, which is for manipulating a window’s position and dimensions.
Syntax
| Method | URI template |
|---|---|
GET | /session/{session id}/window/rect |
URL parameters
session id- : Identifier of the session.
Response
The response payload is a WindowRect:
x- : Horizontal position of the operating system window associated with
window, equivalent toWindow.screenX.
- : Horizontal position of the operating system window associated with
y- : Vertical position of the operating system window associated with
window, equivalent toWindow.screenY.
- : Vertical position of the operating system window associated with
width- : Width of outer bounds of the operating system window associated with
window, equivalent toWindow.outerWidth.
- : Width of outer bounds of the operating system window associated with
height- : Height of the outer bounds of the operating system window associated with
window, equivalent toWindow.outerHeight.
- : Height of the outer bounds of the operating system window associated with
Errors
invalid session id- : Session does not exist.
unexpected alert open- : A user prompt, such as
window.alert, blocks execution of command until it is dealt with.
- : A user prompt, such as
Specifications
SpecificationsStandards references are available on the canonical MDN page.
Browser compatibility
Browser compatibilityCompatibility data is available on the canonical MDN page.
See also
- WebWindow
- Associated commands: