This activity waits until the specified browser element is loaded and then executes some actions based on whether it appeared or not.
In this example we open a page (google.com), wait until the search string element is loaded and then input some text into it.
You can read more about the other mentioned activities here.
An example of a workflow where this activity is used
First of all, we need to define the browser element that will be used here. In this example this is Google search string. This can be done in Studio using Browser Picker. Let us take a look at how it works.
Browser element is the main parameter here. It defines the used browser element. To set up a new element, open the dropdown menu here and click ‘Pick New Element’. If there is an existing element, it will be present in the list and it will be possible to choose it.
Browser element parameter lets you either pick a new element or use an existing one
Browser window will be opened. Hover your cursor over the desired element. If it is recognized, it will be highlighted red. Press Ctrl + X while hovering over the element to pick it. Esc key closes Browser Picker without choosing any elements.
Picker highlights a browser element
As soon as the element is picked, this window will appear. It indicates that the element was found and recognized. You can also set the element name here. It will be displayed in Studio.
It is also possible to view the advanced options by opening the dropdown menu. Advanced options represent the chosen element as a table. It contains the properties and values of this element. This table can be modified in case it is required to refine or correct the element.
Advanced element options
The ‘Test’ button lets you check if the element was defined correctly. Upon clicking it, focus will be shifted to the browser window and the picked element will be highlighted yellow if it was recognized correctly. It can display one of the following messages:
- Found 1 element means that the specific element was successfully recognized.
- Found >1 element means that there are a few similar elements. In this case it is required to repick the element or modify the selector.
- Not found means that the element was not recognized and must be redefined or the advanced options must be corrected.
The ‘Pick’ button lets you pick another element or pick the element once again.
Click ‘Save’ once you are ready. This element will be saved for further usage in Studio activities.
It is also possible to edit an existing element that you have previously picked. To do this, click the ‘Edit element’ button below its name.
This button lets you edit the element
We have just described the Browser element parameter. Now let us move to the other ones.
The next parameter is Waiting time, sec. The program will wait for the element to appear within this time. If the element appeared and was recognized successfully, then the Yes branch of the activity is executed. If not, the No branch will be executed.
Waiting time, sec parameter
And these are the rest of the parameters.
Browser tab, In iframe, Wait before,sec and Wait after, sec parameters
This activity allows you to select the desired browser elements using the "Browser picker".
On tab. This parameter allows you to specify the name of the tab that you want the bot to interact with. The name of the tab is assigned in the "Open URL" activity.
Set a value allows you to manually specify the name of the tab.
Calculate a value allows you to use a special formula or a special method to determine the name of the tab.
Save the previous step result takes the result of the previous workflow action as the name of the tab.
Use tab name in order
This checkbox allows you to specify a sequential number of a tab in the browser. It is worth using if a new tab opens not manually, but automatically after clicking on some element.
The tab selection parameter offers two options: specify the tab number manually or use the "Use tab number by order" checkbox.
Specifying the tab number manually allows you to designate the selected tab independently from the other tabs. That is, if tab "2" is selected in the option and other tabs are actually opened in the browser before it (i.e. the tab becomes, for example, the third one), the activity will be executed in this tab anyway.
The "Use tab number by order" checkbox denotes the tab strictly by the order of the actually opened tabs in the browser. That is, in a similar case (when the desired tab is actually the third), the Browser Picker will work exactly with the second tab of the browser.
It is also possible to click an element in IFrame. Check this parameter if you would like to use this feature. Once it is checked, IFrame parameter will appear. In this specific case this parameter will be required.
Wait before, sec and Wait after, sec parameters indicate how much time will pass before or after executing this activity.