Command catalog
Here is the description of the DSL commands grouped by domain.
Command parameters
A parameter for a command should not contain any coma as it is the separator character.
Application
Command | Example | Description |
---|---|---|
applicationStart |
| Starts an application from its package name. COMPATIBILITY : UNIVERSAL |
applicationKill |
| Forces an application to stop from its package name. COMPATIBILITY : UNIVERSAL |
installApp |
| Installs the application from its package name. |
Browser Manager
Command | Example | Description |
---|---|---|
launchBrowser | Launches the current set browser. If not set, launches default browser Chrome. | |
browserGoToUrl |
| Browses the given url on the current set browser. |
Click
Command | Example | Description |
---|---|---|
longClickByText |
| Performs a long click for the given duration on the element which contains the given text selector. DEFAULT : 1000 OPTIONAL DURATION COMPATIBILITY : UNIVERSAL |
longClickByXY |
| Performs a long click of the given duration on the given coordinate. DEFAULT : 1000 COMPATIBILITY : UNIVERSAL |
clickByText |
| Clicks on the element which contains the given text selector. CASE-SENSITIVE COMPATIBILITY : UNIVERSAL |
clickByTextExact |
| Clicks on the element which contains the exact given text selector. CASE-SENSITIVE COMPATIBILITY : UNIVERSAL |
clickByXY |
| Clicks on the element located at the given coordinates. COMPATIBILITY : UNIVERSAL |
clickByPercent |
| Clicks on the element located at the coordinates calculated from the given percentages of the device screen. COMPATIBILITY : UNIVERSAL |
Device
Command | Example | Description |
---|---|---|
pause |
| Waits the amount of time in millisecond passed as argument. COMPATIBILITY : UNIVERSAL |
Probe
Command | Example | Description |
---|---|---|
measureStart |
| Starts a measure which can be identified by the given name. COMPATIBILITY : UNIVERSAL |
measureStop | Stops the current measure. COMPATIBILITY : UNIVERSAL |
Scroll
Command | Example | Description |
---|---|---|
scrollDownward | Scrolls downward the screen (only one scroll). COMPATIBILITY : UNIVERSAL | |
scrollUpward | Scrolls upward the screen (only one scroll). COMPATIBILITY : UNIVERSAL | |
scrollLeftward | Scrolls leftward the screen (only one scroll). COMPATIBILITY : UNIVERSAL | |
scrollRightward | Scrolls rightward the screen (only one scroll). COMPATIBILITY : UNIVERSAL | |
swipeRightward |
| Swipes rightward the screen. The swipe gesture is from screen point A (X 90%, Y percY) to screen point B (X 10%, Y percY). COMPATIBILITY : UNIVERSAL |
swipeLeftward |
| Swipes leftward the screen. The swipe gesture is from screen point A (X 10%, Y percY) to screen point B (X 90%, Y percY). COMPATIBILITY : UNIVERSAL |
swipeUpward |
| Swipes upward the screen. The swipe gesture is from screen point A (X percX, Y percStartY) to screen point B (X percX, Y 90%). DEFAULT PERCX : 50 DEFAULT PERCSTARTY : 10 OPTIONAL PERC COMPATIBILITY : UNIVERSAL |
swipeDownward |
| Swipes downward the screen. The swipe gesture is from screen point A (X percX, Y percStartY) to screen point B (X percX, Y 10%). DEFAULT PERCX : 50 DEFAULT PERCSTARTY : 90 OPTIONAL PERC COMPATIBILITY : UNIVERSAL |
swipeVertical |
| Swipes vertically the screen. The swipe gesture is from screen point A (X percX, Y percStartY) to screen point B (X percX, Y percEndY). DEFAULT DURATION : 500 OPTIONAL DURATION COMPATIBILITY : UNIVERSAL |
swipeHorizontal |
| Swipes horizontally the screen. The swipe gesture is from screen point A (X percStartX, Y percY) to screen point B (X percEndX, Y percY). DEFAULT DURATION : 500 OPTIONAL DURATION COMPATIBILITY : UNIVERSAL |
Set Text
Command | Example | Description |
---|---|---|
setTextByText |
| Pastes the given text into the element which contains the given text selector. COMPATIBILITY : UNIVERSAL |
setTextByTextExact |
| Pastes the given text into the element which has the given exact text selector. COMPATIBILITY : UNIVERSAL |
enterText |
| Enters the given text in the current selected field clicking on the keyboard keys for each character. Text is entered character by character at the given frequency OPTIONAL FREQUENCY COMPATIBILITY : UNIVERSAL |
enterTextFast |
| Taps the text specified in parameter. Enter all text at once. COMPATIBILITY : UNIVERSAL |
Wait Object
Command | Example | Description |
---|---|---|
waitUntilText |
| Waits for a view element with text specified, to become visible on the screen until a specified timeout. If it is not found, an error is thrown. CASE-INSENSITIVE DEFAULT TIMEOUT: 30000 OPTIONAL TIMEOUT COMPATIBILITY : UNIVERSAL |
waitUntilAccessibilityField |
| Waits for a view element with name (Appium Inspector) or identifier (dump) specified, to become visible on the screen until a specified timeout. If it is not found, an error is thrown. CASE-INSENSITIVE DEFAULT TIMEOUT: 30000 OPTIONAL TIMEOUT COMPATIBILITY : UNIVERSAL |
waitUntilTextBeforeClick |
| Waits for a view element with text specified, to become visible on the screen and then clicks on it. If false, it waits 10 second max before the error thrown. If true, it waits 2 seconds max. DEFAULT BOOLEAN : FALSE OPTIONAL BOOLEAN COMPATIBILITY : UNIVERSAL |
waitUntilAccessibilityFieldBeforeClick |
| Waits for a view element with name (Appium Inspector) or identifier (dump) specified, to become visible on the screen and then clicks on it. If false, it waits 10 second max before the error thrown. If true, it waits 2 seconds max. DEFAULT BOOLEAN : FALSE OPTIONAL BOOLEAN CASE-INSENSITIVE COMPATIBILITY : UNIVERSAL |
waitUntilTextExact |
| Waits for a view element, with the exact text selected, to become visible on the screen until a specified timeout. If it is not found, an error is thrown. CASE-SENSITIVE DEFAULT TIMEOUT: 30000 OPTIONAL TIMEOUT COMPATIBILITY : UNIVERSAL |
waitUntilTextExactBeforeClick |
| Waits for a view element, with the exact text selected, to become visible on the screen and then clicks on it. If false, it waits 10 second max before the error thrown. If true, it waits 2 seconds max. CASE-SENSITIVE DEFAULT BOOLEAN : FALSE OPTIONAL BOOLEAN COMPATIBILITY : UNIVERSAL |
waitUntilAccessibilityFieldExact |
| Waits for a view element, with the exact name (Appium Inspector) or identifier (dump) selected, to become visible on the screen until a specified timeout. If it is not found, an error is thrown. CASE-SENSITIVE DEFAULT TIMEOUT: 30000 OPTIONAL TIMEOUT COMPATIBILITY : UNIVERSAL |
waitUntilAccessibilityFieldExactBeforeClick |
| Waits for a view element, with the exact name (Appium Inspector) or identifier (dump) selected, to become visible on the screen and then clicks on it. If false, it waits 10 second max before the error thrown. If true, it waits 2 seconds max. CASE-SENSITIVE DEFAULT BOOLEAN : FALSE OPTIONAL BOOLEAN COMPATIBILITY : UNIVERSAL |
waitUntilGoneText |
| Waits until there is no view element, with text selected, visible on the screen until a specified timeout. If it is still found, an error is thrown. CASE-INSENSITIVE DEFAULT TIMEOUT: 30000 OPTIONAL TIMEOUT COMPATIBILITY : UNIVERSAL |
waitUntilGoneTextExact |
| Waits until there is no view element, with the exact text selected, visible on the screen until a specified timeout. If it is still found, an error is thrown. CASE-SENSITIVE DEFAULT TIMEOUT: 30000 OPTIONAL TIMEOUT COMPATIBILITY : UNIVERSAL |
waitUntilGoneAccessibilityField |
| Waits until there is no view element, with name (Appium Inspector) or identifier (dump) selected, visible on the screen until a specified timeout. If it is still found, an error is thrown. CASE-INSENSITIVE DEFAULT TIMEOUT: 30000 OPTIONAL TIMEOUT COMPATIBILITY : UNIVERSAL |
waitUntilGoneAccessibilityFieldExact |
| Waits until there is no view element, with name (Appium Inspector) or identifier (dump) selected, visible on the screen until a specified timeout. If it is still found, an error is thrown. CASE-SENSITIVE DEFAULT TIMEOUT: 30000 OPTIONAL TIMEOUT COMPATIBILITY : UNIVERSAL |