Mobile Web Browser

List of all mobile browser commands:

<click>

Description: command to perform click

Required parameters:

1. comment
2. locator – locator, where the click will be performed

Optional parameters:

1. method – click method (selenium or javascript)
2. highlight – boolean, where 'true' means imputed text will be highlighted with a grey body and 3px solid yellow border
3. condition - condition according to which this test step will or won't be executed
4. threshold - parameter, where the maximum execution time of the command is defined (milliseconds), if the execution time is exceeded, the step will be defined as failed
5. locatorStrategy - to select the type of locator, if necessary writing it directly in the field for locator (locatorId - default value) more in Locators tab

<click comment="Click continue with email"

      locator="demoNative.clickContinue"/>

<input>

Description: command to enter a value into the specific field (requires a locator of this field)

Required parameters:

1. comment
2. locator of the field into which a value will be inputted
3. value – non-empty string

Optional parameters:

1. highlight – boolean, where 'true' means imputed text will be highlighted with a grey body and 3px solid yellow border
2. condition - condition according to which this test step will or won't be executed
3. threshold - parameter, where the maximum execution time of the command is defined (milliseconds), if the execution time is exceeded, the step will be defined as failed
4. locatorStrategy - to select the type of locator, if necessary writing it directly in the field for locator (locatorId - default value) more in Locators tab

<input comment="Input comment text"

       locator="todoistMini.commentField"

       value="Thank you for your attention!!!"/>

<wait>

Description: command that pauses the passage of the scenario to perform a certain function that requires a wait. The scenario continues running in the usual way after this command

Required parameters:

1. comment
2. time – integer value

Optional parameters:

1. clickable - pauses execution until a specific element on a webpage or interface becomes clickable, or as much as was specified in the time field, but in the case when the element was not defined as a clickable for a specified time, wait step will fail. The presence of the specified element in the DOM of the page is mandatory, otherwise the element will be determined as not found

   1. comment
   2. locator

2. visible - pauses until a specific element becomes visible on a webpage or interface, which means that the element is in the DOM of the page, but it is defined as invisible (for example: an element that must be hovered over to see it style="display: none;")

   1. comment
   2. locator

3. unit – seconds or milliseconds. Seconds are used as default if the unit param is not used

4. condition - condition according to which this test step will or won't be executed

5. threshold - parameter, where the maximum execution time of the command is defined (milliseconds), if the execution time is exceeded, the step will be defined as failed

<wait comment="Wait for 10seconds or less until element become clickable" time="10" threshold="1000">

    <clickable comment="Wait for 10 or less seconds until element become clickable" locator="login.signIn"/>

</wait>

​

<wait comment="Wait 1 second" time="1000" unit="millis"/>

​

<wait comment="Wait 10 seconds" time="10000" unit="millis" threshold="500">

   <visible comment="Wait for 10 or less seconds until element become visible" locator="login.mail"/>

</wait>

<clear>

Description: command to clear the data that has been entered in the specific field (requires a locator of this field)

Required parameters:

1. comment
2. locator of the field which must be cleared
3. highlight - boolean, where 'true' means cleared text will be highlighted with a grey body and 3px solid yellow border

Optional parameters:

1. condition - condition according to which this test step will or won't be executed
2. threshold - parameter, where the maximum execution time of the command is defined (milliseconds), if the execution time is exceeded, the step will be defined as failed
3. locatorStrategy - to select the type of locator, if necessary writing it directly in the field for locator (locatorId - default value) more in Locators tab

<clear comment="Clear password"

       locator="demoNative.clear"

       highlight="true"/>

<assert>

Description: command to check whether the data is entered or the element is displayed on the page

There are four types:

• attribute - assert by any UI element's attribute
• title - assert by title of the page
• equal - equality of two or more values is checked
• notEqual - the inequality of two or more values is checked
• checked - verifies if checkboxes or radio buttons are selected
• present - checks if an element exists on the page
• alert - verifies the presence and content of alert messages

Required attribute for each type:

1. comment

Optional attribute for each type :

1. condition - condition according to which this test step will or won't be executed
2. threshold - parameter, where the maximum execution time of the command is defined (milliseconds), if the execution time is exceeded, the step will be defined as failed
3. locatorStrategy - to select the type of locator, if necessary writing it directly in the field for locator (locatorId - default value) more in Locators tab
4. negative - when 'true' is selected, it is checked that the expected and actual content do not match (default value - false)

Required parameters according to the type:

1. attribute

   1. comment
   2. locator - locator of the UI element
   3. name - name of attribute
      1. content - content of the attribute

2. title

   1. comment
      1. content - title of the page

3. equal

   1. comment
      1. content - values for comparison (The minimum number must be two)

4. notEqual

   1. comment
      1. content - values for comparison (The minimum number must be two)

5. alert

   1. comment
      1. text - alert text for comparison

6. checked

   1. comment
      1. locator - locator of the UI element

7. present

   1. comment
      1. locator - locator of the UI element

<assert comment="Check that element is present on the page">

    <attribute comment="Assert 'password' field"

               name="name" - name of attribute for asserting (id,name,outerHTML,etc)

               locator="registration.inputPassword"> - locator of the element to assert

        <content>password</content> - content of the attribute

    </attribute>

</assert>

You can assert several elements within one <assert>:

<assert comment="Test for Assert with sub-commands - notEqual, equal, attribute, title">     

    <attribute comment="Assert 'password' field" name="name" locator="registration.inputPassword">

        <content>password</content>

    </attribute>

​

    <title comment="Check whether title of the page is correct">

        <content>Default store | Login</content>

    </title>

    <notEqual comment="Assert for check that 3 different contents is not equal">

        <content>one</content>

        <content>1</content>

        <content>{{ONE}}</content>

    </notEqual>

    <equal comment="Assert for check that two contents is equal">

        <content>one</content>

        <content>{{one}}</content>

    </equal>

    <assert comment="Asserting for present and Not present element on the page">

         <present comment="Check that element on page is present" locator="forms.save"/>

         <present comment="Check that element on page is NOT present" locator=".//img[@alt= 'Sunset in the mountains']" locatorStrategy="xpath" negative="true"/>

    </assert>

​

     <assert comment="Asserting on page">

         <checked comment="Check that checkbox is NOT chosen" locator="uiElements.checkbox" negative="true"/>

     </assert>

​

     <assert comment="Asserting on page">

         <checked comment="Check that checkbox is chosen" locator="uiElements.checkbox" negative="false"/>

     </assert>

​

     <assert comment="Asserting on page">

         <alert comment="Check that alert equal expected content">

             <text>Alert!</text>

         </alert>

         <alert comment="Check that alert not equal expected content" negative="true">

             <text>Alert</text>

         </alert>

     </assert>

</assert>

<scroll>

Description: command to perform scroll action

Required parameters:

1. comment

2. type – a type of the scroll

   1. whole page
   2. inner (inside element on the page)

3. value – a value of the scroll

Optional parameters:

1. direction – up or down. Down is default
2. measure – how value is measured (pixels or percent). Pixels are default.
3. locator – if a type is “inner”, the locator for an element is needed to be provided
4. condition - condition according to which this test step will or won't be executed
5. threshold - parameter, where the maximum execution time of the command is defined (milliseconds), if the execution time is exceeded, the step will be defined as failed
6. locatorStrategy - to select the type of locator, if necessary writing it directly in the field for locator (locatorId - default value) more in Locators tab

<scroll comment="Scroll Down to 90 per cent"

        value="90"

        direction="down"

        measure="percent"

        type="page"/>

<scrollTo>

Description: command to perform scroll-to-element action

Required parameters:

1. comment
2. locator – locator of the element to which scroll to action will be performed

Optional parameters:

1. condition - condition according to which this test step will or won't be executed
2. threshold - parameter, where the maximum execution time of the command is defined (milliseconds), if the execution time is exceeded, the step will be defined as failed
3. locatorStrategy - to select the type of locator, if necessary writing it directly in the field for locator (locatorId - default value) more in Locators tab

<scrollTo comment="Scroll to 'contact' button in footer"

          locator="mobileScrollTo.login"/>

<navigate>

Description: command to perform navigation

Required parameters:

1. comment
2. command (back, reload or to)

Optional param:

1. path – if the command is “to” string path should be provided
2. condition - condition according to which this test step will or won't be executed
3. threshold - parameter, where the maximum execution time of the command is defined (milliseconds), if the execution time is exceeded, the step will be defined as failed

<navigate comment="Go to main page"

          command="to"

          path="/register"/>

<tab>

Description: command to perform operations with tabs

There are three types:

• close
• switch
• open

Required attribute for each type:

1. comment

Optional attribute for each type :

1. condition - condition according to which this test step will or won't be executed
2. threshold - parameter, where the maximum execution time of the command is defined (milliseconds), if the execution time is exceeded, the step will be defined as failed

Required parameters according to the type:

1. close

   1. index - index of tab that should be closed. (If you do not specify the index, it will be close current tab)

2. switch

   1. index - switch to tab with selected index.

3. open

   1. url - open a tab via specified URL

<tab comment="Switch to second tab">

   <switch index="2"/>

</tab>

​

<tab comment="Close tab with index 2">

   <close index="2"/>

</tab>

​

<tab comment="Open a tab via url">

   <open url="http://URL"/>

</tab>

<tab comment="Close current tab">

   <close/>

</tab>

<javascript>

Description: command to execute user's javascript commands

Required parameters:

1. comment
2. file – file with js commands

Optional parameters:

1. condition - condition according to which this test step will or won't be executed
2. threshold - parameter, where the maximum execution time of the command is defined (milliseconds), if the execution time is exceeded, the step will be defined as failed

<javascript comment="Your comment"

            file="function.js"/>

<hovers>

Description: command to perform hover action

Required parameters:

1. comment
2. locator of the UI element you want to perform hover action with

Optional parameters:

1. condition - condition according to which this test step will or won't be executed
2. threshold - parameter, where the maximum execution time of the command is defined (milliseconds), if the execution time is exceeded, the step will be defined as failed
3. locatorStrategy - to select the type of locator, if necessary writing it directly in the field for locator (locatorId - default value) more in Locators tab

<hovers comment="Open dropdown list with 'hover' function">

    <hover comment="Open drop down 'Select Country' tab" locator="mobileHover.hoverCountry"/>

</hovers>

<dropDown>

Description: command to select from the drop-down list menu

Option to choose: oneValue or allValues;

Required parameters:

1. comment
2. locator of the dropDown element

oneValue:

1. type – select or deselect
2. by – options how to select: a)Text; b)Value; c)Index
3. value – non-empty string value that represents one of the “by” selector values

allValues:

1. type – select or deselect

Optional parameters:

1. condition - condition according to which this test step will or won't be executed
2. threshold - parameter, where the maximum execution time of the command is defined (milliseconds), if the execution time is exceeded, the step will be defined as failed
3. locatorStrategy - to select the type of locator, if necessary writing it directly in the field for locator (locatorId - default value) more in Locators tab

<dropDown comment="Add country Canada" locator="mobileSelectDropDown.selectCountry">

    <oneValue type="select" by="value" value="CA"/>

</dropDown>

<switchToFrame>

Description: command for switching between frames

Option to choose: click, input, assert, dropDown, wait, clear, scroll, scrollTo, image, javascript, navigate, hovers, closeTab, switchToFrame

Required parameters:

1. comment
2. locator for the destination frame

Optional parameters:

1. condition - condition according to which this test step will or won't be executed
2. threshold - parameter, where the maximum execution time of the command is defined (milliseconds), if the execution time is exceeded, the step will be defined as failed
3. locatorStrategy - to select the type of locator, if necessary writing it directly in the field for locator (locatorId - default value) more in Locators tab

<switchToFrame comment="Open api frame on the site"

               locator="frame.page">

    <input comment="Add email the page"

           locator="frame.email"

           value="test@gmail.com"/>

​

    <clear comment="Clear email"

           locator="frame.clear"

           highlight="true"/>

​

    <click comment="Click button"

           locator="frame.button"/>

</switchToFrame>

<image>

Description: command to take a screenshot and compare it with the expected result

There are three types:

• fullScreen (compare a full screenshot)
• picture (compare image file by locator)
• part (compare a part screenshot of the specific element by locator)

Required attribute for each type:

1. comment
2. file - expected image file to compare with screenshot

Optional attribute for each type :

1. condition - condition according to which this test step will or won't be executed
2. threshold - parameter, where the maximum execution time of the command is defined (milliseconds), if the execution time is exceeded, the step will be defined as failed
3. highlightDifference - parameter that turns on/off highlighting of difference

Required parameters according to the type:

1. fullScreen

   1. percentage - the percentage of accuracy of the screenshot comparison, where 100% is the comparison of the entire screenshot (if not indicated it will be considered as 100)

2. picture

   1. locator - locator of the specific image element
   2. attribute - image source attribute name. DEFAULT=src

3. part

   1. locator - locator of the specific element what to compare
   2. percentage - the percentage of accuracy of the screenshot comparison, where 100% is the comparison of the entire screenshot (if not indicated it will be considered as 100)

NOTE:

Image comparison is a test feature. On multiple devices, the same window can have different dimensions so the comparison will be failed. Comparison of specific elements works fine due to our tests.

<image comment="Compare full screen with percentage less then 100" file="compare1.png">

     <fullScreen percentage="88"/>

</image>

​

<image comment="Compare full screen" file="compare2.png" highlightDifference="true">

    <fullScreen/>

</image>

​

<image comment="Compare a part of screen with percentage less then 100" file="compare3.png">

    <part locator="forms.form" percentage="99"/>

</image>

Also, using the command, you can check the display of the image of some element:

<image comment="Compare image from the page"

       file="compare2.png"> - expected picture

    <picture locator="image.compare"/> - locator ID of the picture to be compared

</image>

<repeat>

Description: command that allows you to repeat any action used in the commands

Required parameters:

1. comment

Optional parameters:

1. condition - condition according to which this test step will or won't be executed
2. threshold - parameter, that set maximum allowed test step execution time
3. times - is to set the number of repeating (not used with variations)
4. variations - attribute for the variations file (not used with times)

<mobilebrowser comment="Start Mobile Browser scripts">

    <repeat comment="Check the ability to run variations in repeat" variations="variations_2.csv">

        <click comment="Click on drop down filed" locator="uiElements.dropDownField"/>

​

        <click comment="Click on first options" locator="uiElements.firstOptions"/>

​

        <wait comment="Wait for 1 second" time="1"/>

    </repeat>

</mobilebrowser>

Inside the mobilebrowser <repeat> command you can use any mobilebrowser commands.

<dragAndDrop>

Description: command that allows you to check by clicking on an object and dragging it to another location

Required parameters:

1. comment
2. toLocator - locator id of the place, where you need to drop an element
3. fromLocator - locator id of the element which you need to drag and drop

Optional parameters:

1. condition - condition according to which this test step will or won't be executed
2. threshold - parameter, where the maximum execution time of the command is defined (milliseconds), if the execution time is exceeded, the step will be defined as failed
3. fileName - if you need to upload the file, you can put file name in this parameter, file must be in the same path as scenario
4. locatorStrategy - to select the type of locator, if necessary writing it directly in the field for locator (locatorId - default value) more in Locators tab fromLocator

<dragAndDrop comment="Drag and drop action"

             toLocator="nativeDrag.dragFirst">

    <fromLocator>nativeDrag.dropSecond</fromLocator>

</dragAndDrop>

It is also possible to upload any file to the site due to this command.

<dragAndDrop comment="Add image with dragAndDrop example" toLocator="dragAndDrop.image">

    <fileName>/home/user/image.jpg</fileName>

</dragAndDrop>

<include>

Description: the command that allows you to run a ‘scenario inside a scenario’ (often used to bundle different scenarios)

Required parameters:

1. comment
2. scenario - path to the scenario you need to launch. Since all scenarios must be stored in 'scenarios' folder, in this parameter you need specify path to your scenario from 'scenario' folder

Optional parameters:

1. condition - condition according to which this test step will or won't be executed
2. threshold - parameter, that set maximum allowed test step execution time

<include comment="Include login steps"

         scenario="/includes/login/scenario.xml"/>