GDSL commands for iOS

update 25 nov 2024

Command catalog

Here is the description of the DSL commands grouped by domain.

  • Application

  • Browser Manager

  • Click

  • Device

  • Find

  • Probe

  • Scroll

  • Set text

  • Wait objects

 

A parameter for a command should not contain any comma as it is the separator character.

Application

Command

Example

Description

applicationStart

applicationStart,[PACKAGE]

Starts an application from its package name.

compatibility : universal

applicationKill

applicationKill,[PACKAGE]

Forces an application to stop from its package name.

compatibility : universal

installApp

installApp,[PACKAGE]

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

browserGoToUrl,https://greenspector.com/

Browses the given url on the current set browser.

browserClearCache

 

Clears the cache of Safari.

browserPrepareAndOpen

 

Prepares browser for measurement. Clear cache, close all tabs, close browser and reopen it.

browserPrepareAndOpenForReference

 

Prepares browser for measurement. Clear cache, close all tabs, close browser and reopen it, go to a black page and wait 60s.

Click

Command

Example

Description

longClickByText

longClickByText,[TEXT]

longClickByText,[TEXT],[DURATION]

Performs a long click for the given duration on the element which contains the given text selector.

default : 1000 optional duration compatibility : universal

longClickByXY

longClickByXY,[X-POS],[Y-POS]

Performs a long click of the given duration on the given coordinate.

default : 1000 compatibility : universal

clickByText

clickByText,[TEXT]

Clicks on the element which contains the given text selector.

CASE-SENSITIVE compatibility : universal

clickByTextExact

clickByTextExact,[TEXT]

Clicks on the element which contains the exact given text selector.

CASE-SENSITIVE compatibility : universal

clickByXY

clickByXY,[X-Pos],[Y-Pos]

Clicks on the element located at the given coordinates.

compatibility : universal

clickByPercent

clickByPercent,[X-Perc],[Y-Perc]

Clicks on the element located at the coordinates calculated from the given percentages of the device screen.

compatibility : universal

clickByTextOnSystemPopup

clickByTextOnSystemPopup,[TEXT]

Clicks on a system popup that is not detected automatically which contains the given text selector. System popups that are detected automatically are accepted by default.

clickOnLastElementFound

 

Clicks on the last element found by previous GDSL command in group Find like findByText or findByTextExact.

compatibility : universal

Device

Command

Example

Description

pause

pause,[DURATION]

Waits the amount of time in millisecond passed as argument.

compatibility : universal

pressHome

pressHome

Presses the home button.

compatibility : universal

pressVolumeDown

pressVolumeDown

Presses the volume down button.

compatibility : universal

pressVolumeUp

pressVolumeUp

Presses the volume up button.

compatibility : universal

Find

Command

Example

Description

findByText

findByText,[TEXT]

findByText,[TEXT],[RANK]

Finds the nth element which text or content-desc contains the given selector. The element is saved as the last element found.

CASE-SENSITIVE default rank : 1 optional rank compatibility : universal

findByTextExact

findByText,[EXACT-TEXT]

findByText,[EXACT-TEXT],[RANK]

Finds the nth element which text or content-desc is the exact given selector. The element is saved as the last element found.

CASE-SENSITIVE default rank : 1 optional rank compatibility : universal

findByClass

findById,[CLASS]

findById,[CLASS],[RANK]

Finds the nth element with the class selector. The element is saved as the last element found.

default rank : 1 optional rank compatibility : universal

Probe

Command

Example

Description

measureStart

measureStart,CHRGT_home

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

swipeRighward,[percY]

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

swipeLeftward,[percY]

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

swipeUpward

swipeUpward,[percX],[percStartY]

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

swipeDownward

swipeDownward,[percX],[percStartY]

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

swipeVertical,[percStartY],[percEndY],[percX]

swipeVertical,[percStartY],[percEndY],[percX],[DURATION]

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

swipeHorizontal,[percStartX],[percEndX],[percY]

swipeHorizontal,[percStartX],[percEndX],[percY],[DURATION]

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

swipeDownwardToText

swipeDownwardToText,[TEXT]

swipeDownwardToText,[TEXT],[ITERATION],[percX]

Swipes downward to find the first element which contains the given selector. The swipe gesture is from screen point A (X 50%, Y 90%) to screen point B (X 50%, Y 10%).

case-insensitive default iterations : 10 (max 30) compatibility : universal

swipeUpwardToText

swipeUpwardToText,[TEXT]

swipeUpwardToText,[TEXT],[ITERATIONS],[percX]

Swipes upward to find the first element which contains the given selector. The swipe gesture is from screen point A (X 50%, Y 10%) to screen point B (X 50%, Y 90%).

CASE-SENSITIVE default iterations : 10 (max 30) default percx: 50 optional iterations and percx compatibility : universal

Set Text

Command

Example

Description

setTextByText

setTextByText,[TEXT],[TEXT-SELECTOR]

Pastes the given text into the element which contains the given text selector.

compatibility : universal

setTextByTextExact

setTextByText,[TEXT],[EXACT-TEXT-SELECTOR]

Pastes the given text into the element which has the given exact text selector.

compatibility : universal

enterText

enterText,[TEXT]

enterText,[TEXT],[FREQUENCY]

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

enterTextFast,[TEXT]

Taps the text specified in parameter. Enter all text at once.

compatibility : universal

Wait Object

Command

Example

Description

waitUntilText

waitUntilText,[TEXT]

waitUntilText,[TEXT],[TIMEOUT]

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

waitUntilDesc,[NAME/ID]

waitUntilDesc,[NAME/ID],[TIMEOUT]

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

  • waitUntilTextBeforeClick,[TEXT] = waitUntilTextBeforeClick,[TEXT],false

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

  • waitUntilDescBeforeClick,[NAME/ID] = waitUntilDescBeforeClick,[NAME/ID],false

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

waitUntilTextExact,[EXACT-TEXT]

waitUntilTextExact,[EXACT-TEXT],[TIMEOUT]

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

  • waitUntilTextExactBeforeClick,[EXACT-TEXT] = waitUntilTextExactBeforeClick,[EXACT-TEXT],false

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

waitUntilDescExact,[EXACT-NAME/ID]

waitUntilDescExact,[EXACT-NAME/ID],[TIMEOUT]

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

  • waitUntilDescExactBeforeClick,[EXACT-NAME/ID] = waitUntilDescExactBeforeClick,[EXACT-NAME/ID],false

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

waitUntilGoneText,[TEXT]

waitUntilGoneText,[TEXT],[TIMEOUT]

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

waitUntilGoneTextExact,[EXACT-TEXT]

waitUntilGoneTextExact,[EXACT-TEXT],[TIMEOUT]

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

waitUntilGoneDesc,[NAME/ID]

waitUntilGoneDesc,[NAME/ID],[TIMEOUT]

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

waitUntilGoneDescExact,[EXACT-NAME/ID]

waitUntilGoneDescExact,[EXACT-NAME/ID],[TIMEOUT]

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

waitUntilTextOnSystemPopup

waitUntilTextOnSystemPopup,[TEXT]

waitUntilTextOnSystemPopup,[TEXT],[TIMEOUT]

Wait for a system popup that is not detected automatically which contains the given text selector. System popups that are detected automatically are accepted by default.

CASE-inSENSITIVE default timeout: 30000 optional timeout compatibility : universal

Â