Android

Global object. Use it to perform actions not related to a particular object. You do not need to record or learn this object, it is always automatically available in any test.

Action Summary

Action Description
DoFlick Flick action.
DoGoToUrl Opens URL in active browser.
DoPressBack Presses Back button.
DoPressHome Presses Home button.
DoPressKeyCode Presses key with code.
DoPressMenu Presses Menu button.
DoScreenshot Makes screenshot of a device.
DoStartActivity Starts activity.
DoStartVideoRecording Starts video recording on a device.
DoStopVideoRecording Stops video recording on a device.
DoSwipe Swipe action.
DoTap Tap screen.
GetCapability Gets capability with specified name.
GetContext Gets current context.
SetContext Sets context.

Action Detail

DoFlick(endX, endY, startX, startY, touchCount)

Flick action.

Parameters:

Name Type Description
endX number x coordinate where swipe ends (in pixels or relative units)
endY number y coordinate where swipe ends (in pixels or relative units)
startX number x coordinate where swipe begins (in pixels or relative units)
Optional.
startY number y coordinate where swipe begins (in pixels or relative units)
Optional.
touchCount number how many fingers to swipe with
Optional.

Returns:

'true' if successful, 'false' otherwise.

DoGoToUrl(url)

Opens URL in active browser.

Parameters:

Name Type Description
url string

Returns:

'true' if successful, 'false' otherwise.

DoPressBack()

Presses Back button.

Returns:

'true' if successful, 'false' otherwise.

DoPressHome()

Presses Home button.

Returns:

'true' if successful, 'false' otherwise.

DoPressKeyCode(keyCode)

Presses key with code.

Parameters:

Name Type Description
keyCode number Key code: http://developer.android.com/reference/android/view/KeyEvent.html

Returns:

'true' if successful, 'false' otherwise.

DoPressMenu()

Presses Menu button.

Returns:

'true' if successful, 'false' otherwise.

DoScreenshot()

Makes screenshot of a device.

Returns:

'true' if successful, 'false' otherwise.

DoStartActivity(appPackage, appActivity)

Starts activity.

Parameters:

Name Type Description
appPackage string Package name.
appActivity string Activity name.

Returns:

'true' if successful, 'false' otherwise.

DoStartVideoRecording()

Starts video recording on a device.

Returns:

'true' if successful, 'false' otherwise.

DoStopVideoRecording()

Stops video recording on a device.

Returns:

'true' if successful, 'false' otherwise.

DoSwipe(endX, endY, startX, startY, duration, touchCount)

Swipe action.

Parameters:

Name Type Description
endX number x coordinate where swipe ends (in pixels or relative units)
endY number y coordinate where swipe ends (in pixels or relative units)
startX number x coordinate where swipe begins (in pixels or relative units)
Optional.
startY number y coordinate where swipe begins (in pixels or relative units)
Optional.
duration number time (in seconds) to spend performing the swipe/drag
Optional.
touchCount number how many fingers to swipe with
Optional.

Returns:

'true' if successful, 'false' otherwise.

DoTap(x, y, duration, tapCount, touchCount)

Tap screen.

Parameters:

Name Type Description
x number x coordinate to tap (in pixels or relative units)
Optional.
y number y coordinate to tap (in pixels or relative units)
Optional.
duration number how long (in seconds) to tap
Optional.
tapCount number how many times to tap
Optional.
touchCount number how many fingers to tap with
Optional.

Returns:

'true' if successful, 'false' otherwise.

GetCapability(name)

Gets capability with specified name.

Parameters:

Name Type Description
name string Name of a capability.

Returns:

Capability string.

GetContext()

Gets current context.

Returns:

Either NATIVE_APP or WEBVIEW_1.

SetContext(name)

Sets context.

Parameters:

Name Type Description
name string Either NATIVE_APP or WEBVIEW_1.