iOS

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.
DoScreenshot Makes screenshot of a device.
DoShake Shakes device.
DoSwipe Swipe action.
DoTap Tap screen.
GetCapability Gets capability with specified name.
GetContext Gets current context.
GetDeviceOrientation Gets device orientation.
SetContext Sets context.
SetDeviceOrientation Sets device orientation.

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.

DoScreenshot()

Makes screenshot of a device.

Returns:

'true' if successful, 'false' otherwise.

DoShake()

Shakes 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.

GetDeviceOrientation()

Gets device orientation.

Returns:

Device orientation.

SetContext(name)

Sets context.

Parameters:

Name Type Description
name string Either NATIVE_APP or WEBVIEW_1.

SetDeviceOrientation(orientation)

Sets device orientation.

Parameters:

Name Type Description
orientation number ORIENTATION_PORTRAIT, ORIENTATION_LANDSCAPE

Returns:

Device orientation.