Perform Actions
Perform actions are action keywords that help you perform basic operations on an element.
Suppose you wish to perform click on an element.
Structure :
launchApp <parameters>
verifyElementVisible <parameters>
click <parameters>
Â
All keywords under this list hard fail in negative scenarios.
Â
Action | Parameters | Example Usage |
|---|---|---|
click
To perform the click operation on object (mentioned in objectName). | Â | Example :
Clicks on the mentioned object bqObject. |
closeWindowByTitle
To close the window using title (mentioned in Parameter 1). | Param 1 : Window title to close | Example :
Closes the window with title bqurious features |
clickOnLinkByText
To click on the link by text (mentioned in Parameter 1) inside the frame (Frame path or Index mentioned in Parameter 3) with index (mentioned in Parameter 2) using Javascript. If index is not mentioned, the first instance of link will be clicked inside the frame using Javascript. If parameter 4 is not provided, click will be performed with BQ. | Param 1 : Link Text to click on | Example :
Clicks on first instance of link bqurious inside the frame index 1, using Javascript. |
clickAtXY
To click at specific location using coordinates. | Param 1 : X-coordinate | Example :
Clicks at 120,178 coordinates. |
clickOnElementWithOffset
To perform the click operation on object (mentioned in objectName) using x-offset % (mentioned in Parameter 1) and y-offset % (mentioned in Parameter 2). | Param 1 : X-coordinate(%) | Example :
|
clickLinkByText
To click on the link (mentioned in Parameter 1) at index (mentioned in Parameter 2). If index is not mentioned, the first instance of link will be clicked. If True is provided in parameter 3, javascript will be used to click internally. | Param 1 : Link text to be clicked | Example :
Clicks on first instance of bqurious using Javascript
Clicks on the second instance of bqurious, under the object bqObject |
collapseNode
To collapse the tree node (KEY or PATH mentioned in Parameter 1) from UITree (mentioned in Object Name). Node Path is not applicable for Web. | Param 1 : Node key or node path | Example 1 :
|
clickGridItemByIndex
To click the grid item with index (mentioned in Parameter 1) in grid object (mentioned in objectName). | Param 1 : Option at index | Example :
Clicks on the grid item at index 3 in grid object bqGrid. |
closeApp
To close the application which is currently open in simulator or device. | Â | Example :
Closes the currently open mobile application. Â |
deSelectCheckBox
To de-select the check-box object (mentioned in objectName). | Â | Example :
De-selects the check-box bqCheckbox |
doubleClick
To perform the double-click operation on object (object mentioned in objectName). | Â | Example :
Performs double-click on object bqObject. |
doubleClickAtXY
To double-click at a specific location using coordinates. | Param 1 : X-coordinate | Example :
Double-clicks at 120,178 coordinates. |
doubleTap
To perform the double tap operation on the object (mentioned in ObjectName). | Param 1 (Optional) : Offset X(%) | Example 1 :
Performs the double tap operation on the bqMobileObject Example 2 :
Performs the double tap operation on mentioned x & y offset (%). Example 3 :
Performs the double tap operation at the center. |
expandNode
To expand the tree node (KEY or PATH mentioned in Parameter 1) from UITree (mentioned in Object Name). | Param 1 : | Example :
|
focusOnElement
To place the focus on object (mentioned in objectName). | Â | Example :
|
installApp
To install the application (mentioned in Parameter 1) on device. | Param 1 : Select the Mobile Application | Example :
Installs the application bqurious on device. |
launchApp
To Launch the application of the specified URL (value mentioned in Parameter 1), with User and Password specified in Param 2 and 3 in case of Basic Auth. | Param 1 : Url to be launched | Example 1 :
Launches URL http://www.bqurious.com Example 2 :
Launches URL https://exampleurl.com by using the provided Basic Auth credentials Example 3 :
Launches URL https://exampleurl.com by using the provided Basic Auth credentials |
launchAppOnDevice
To launch the mobile application on simulator or device without resetting the application. | Param 1 (Optional) : Ignore Reset (true / false) | Example 1 :
Launches the mobile application without resetting the application data. Example 2 :
Default value fetched will be false. Launches the mobile application without resetting the application data. |
longTap
To perform the long tap operation on the object (mentioned in ObjectName). | Param 1 (Optional) : Offset X(%) | Example 1 :
Performs long tap operation on the bqMobileObject Example 2 :
Performs long tap operation on mentioned x & y offset (%). Example 3 :
Performs long tap operation at the center. |
mouseOver
To place the mouse onto the object (mentioned in objectName). | Â | Example :
Places the mouse onto the object bqObject |
navigateBackOnDevice
To navigate to previous screen. |  | Example :
Navigates to the previous screen. |
pressRemoteButton
To press button (mentioned in Parameter 1) for number of times (mentioned in Parameter 2). | Param 1 : Name of the button | Example :
Clicks the down button for 5 times to reach the appropriate element |
rightClick
To perform the right-click operation on object (mentioned in objectName). | Â | Example :
Performs right-click on object bqObject. |
rightClickAtXY
To perform right-click at a specific location using coordinates. | Param 1 : X-coordinate | Example :
|
selectCheckBox
To select the check-box object (mentioned in objectName). | Â | Example :
Selects the check-box bqCheckbox |
setValue
To enter the value (mentioned in Parameter 1) in edit-box object (mentioned in objectName) or the pre-focused edit-box (when no object is provided). | Param 1 : Value to be set | Example 1 :
Sets Bqurious in edit-box bqTextbox Example 2 :
Sets Bqurious in the pre-focused edit-box |
setValueOnReadOnlyField
To enter the Value (mentioned in Parameter 1) in text box which is read-only. | Param 1 : Value to set | Example :
Enters 41237 in object bqTextboxReadOnly. |
switchToWindowByTitle
To shift the control from one window to another using title of the window to perform actions. | Param 1 : Window title to switch to | Example :
Switches to window that has title bqVariable, from the previous window |
selectRadioButton
To select the radio-button (mentioned in objectName). |  | Example :
Selects the radio-button object bqRadiobutton. |
scrollElementIntoView
To scroll the page to make the object (mentioned in object name) visible on the screen. | Â | Example :
|
selectDefaultFrame
To switch control to top window or default frame to perform actions. | Â | Example :
|
selectValueInListByIndex
To select the value from dropdown/multi-select object (mentioned in objectName) using index. | Param 1 : Index | Example :
|
selectByTextInList
To select the specific option (mentioned in Parameter 1) on object (mentioned in objectName). | Param 1 : List Item text to select | Example :
|
setFile
To select the file name located at (Mentioned in Parameter 1) from the file system. | Param 1 : File name with path | Example :
|
switchApp
To switch the application type from Web to Applet or Applet to Web. | Param 1 : Switch to type of application | Example :
|
switchMobileApp
To switch to mobile native application that has the specific bundle name (mentioned in Parameter 1). | Param 1 : Package / Bundle Name | Example :
Switches to native application with package name com.bq.mobile.native on iOS device |
switchMobileBrowser
To switch to mobile browser. | Â | Example :
Switches to mobile browser on device. |
setValueInExcelCell
To enter the value (mentioned in parameter 1) at column (column name or index mentioned in parameter 2) and row index (mentioned in parameter 3). | Param 1 : Value to set | Example :
|
setExcelProps
To configure the excel file properties. | Param 1 : Name of the excel sheet | Example :
Configures the sheet name Sheet3 and header row index is 1. |
setDataRow
To set the row in data file at row number mentioned in Parameter 1 | Param 1 : The row number to start | Example :
Sets the row in data file as 2 |
setExcelRow
To set the row in excel file at row number mentioned in Parameter 1. | Param 1 : The row number to start | Example :
Sets the row in excel file, at row number 3 |
selectTab
To select the tab (mentioned in Parameter 1) from TabStrip (mentioned in Object Name) using text. | Param 1 : Name of the tab | Example :
Selects Allocation tab from Tab Strip AssetTabStrip. |
selectItemByTextInSpinner
To select the spinner item text (mentioned in Parameter 1) in spinner object (mentioned in objectName). | Param 1 : Item Text | Example :
Selects spinner1 in spinner bqSpinner. |
selectItemByIndexInSpinner
To select the item in spinner object (mentioned in objectName) using index (mentioned in Parameter 1). | Param 1 : Option at index | Example :
Selects item in spinner object bqSpinner at index 12. |
selectGalleryItemByIndex
To select the gallery item with index (index mentioned in Parameter 1) from gallery object (mentioned in Object Name). | Param 1 : Item at Index | Example :
Selects gallery item that has index 12 in object bqGallery. Â |
setLocationLatLong
To set the location using latitude (mentioned in Parameter 1), longitude (mentioned in Parameter 2), and altitude (mentioned in Parameter 3). | Param 1 : Location Latitude | Example :
Sets the location using latitude 89.9, longitude 78.98 and altitude 25.8. |
setLocationAddress
To set the location address. | Param 1 : Location address | Example :
Sets the location address as BQ Office. |
switchToWebViewContext
To switch the context to Web view on device. | Â | Example :
Switches the context to Web View on device. |
switchToMobileContext
To switch the context to Mobile on device. | Â | Example :
Switches the context to Mobile on device. |
tap
To perform the tap operation on the object (mentioned in ObjectName). | Param 1 : Offset X(%) | Example :
Performs long tap operation on the bqMobileObject. Example 2 :
Performs tap operation on mentioned x & y offset (%). Example 3 :
Performs tap operation at the center. |
useDevice
To switch device to device (mentioned in parameter 2) to integrate with a different mobile application. | Param 1 : Name of the Mobile Application | Example :
Switches to device iosDevice with UDID as ios01, version as 7.0 & OS type as IOS to integrate with application-02. |