This documentation is deprecated. Please refer to the README in the Appium repository or Appium 2.0 documentation.

Edit this Doc Get Window Position

Get the position of the specified window (Web context only)

Example Usage

Point windowPosition = driver.manage().window().getPosition();

handle_one_position = self.driver.get_window_position()
handle_two_position = self.driver.get_window_position("handleName")

// webdriver.io example
let position = driver.getWindowRect();

// wd example
let handleOnePosition = await driver.getWindowPosition();
let handleTwoPosition = await driver.getWindowPosition("handleName");

# ruby_lib example
window_position
window_position("handleName")

# ruby_lib_core example
@driver.window_position
@driver.window_position("handleName")

Point windowPosition = driver.Manage().Window.Position;

Support

Appium Server

Platform	Driver	Platform Versions	Appium Version	Driver Version
iOS	XCUITest	None	None	None
	UIAutomation	None	None	None
Android	UiAutomator2	None	None	None
	Espresso	None	None	None
	UiAutomator	None	None	None
Mac	Mac	None	None	None
Windows	Windows	None	None	None

Appium Clients

Language	Support	Documentation
Java	All	seleniumhq.github.io
Python	All	selenium-python.readthedocs.io
Javascript (WebdriverIO)	All
Javascript (WD)	All	github.com
Ruby	All	www.rubydoc.info
C#	All	github.com

HTTP API Specifications

Endpoint

GET /session/:session_id/window/:window_handle/position

URL Parameters

name	description
session_id	ID of the session to route the command to
window_handle	Handle of the window to get position of. If 'current' it will get position of current window.

JSON Parameters

None

Response

name	type	description
x	`number`	The x coordinate relative to the top left corner of the window
y	`number`	The y coordinate relative to the top left corner of the window

See Also

JSONWP Specification