История страницы
...
This action is intended to open the selected browser. A context is created when the browser is opened.
Action icon
Action parameters
...
URL The The URL that should be navigated to when the browser is opened
Save in The path to the folder where files should be saved when downloaded
...
Property | Description | Type | Filling example | Mandatory field |
---|---|---|---|---|
Parameters | ||||
Browser | Browser selection Default is Chrome Dropdown list:
| Robin.String | Chrome | No |
Properties | List of browser properties and their values that will be set when the browser starts In JSON format, describing a list of browser properties and their values to be set at launch If the parameter is populated, its values take precedence over the values of the other fields You can connect extensions and set the profile through this parameter | Robin.String | JSON по шаблону | No |
Explicitly wait | Time to wait for changes in the properties of individual elements Specifies a waiting time limit value to be used by default in group actions, determining the time to access items Measured in milliseconds | Robin.Numeric | 10000 | No |
Background mode | Background mode Internet Explorer does not support this setting | Robin.Boolean | true | No |
URL | URL to be navigated after opening the browser | Robin.String | https://google.com/ | No |
Save in | Path to folder to save files | Robin.FolderPath | C:\doc\img | No |
Results | ||||
Context | The browser instance that Selenium will work withBrowser instance with which Selenium will work | Robin.Selenium | Browser context |
Special conditions of use
Пример1Example 1. Example of filling in the "Properties" field (filled in automatically by recording actions in Recorder).
...
Alternatively, you can specify "none" instead of "eager", but then there is a risk that the page will not load. The "eager" value only waits for the page DOM to load, without waiting for scripts, images and other resources to load, the "none" value does not wait at all.
...
Example 2.
...
Driver absence message
When performing the “Open Browser” action, if you use an encoding other than UTF-8 in the env.cfg file - for example, with Cyrillic characters - you may get a situation where if the driver is present, a message about its absence appears:
Result
The actionfailsbecause the driver is notfound.
The reason is a problem in the encoding of the env.cfg file. In our example, on a virtual host, the file was encoded in
...
При выполнении действия "Открыть браузер" при использовании в файле env.cfg кодировки, отличной от UTF-8, например, с кириллицей - может возникнуть ситуация, когда при наличии драйвера, появляется сообщение об его отсутствии:
Результат: действие завершается с ошибкой, потому что драйвер не найден.
Причиной является проблема в кодировке файла env.cfg. В нашем примере на виртуальной машине файл был в кодировке Windows-1251:
Для того, чтобы отработало действие "Открыть браузер", нужно сконвертировать и пересохранить файл в кодировке UTF-8:
Действие будет запущено, робот завершится без ошибки. Браузер откроется.
In order for the "Open Browser"actiontowork, you need to convertandresave the fileinUTF-8 encoding:
The actionwill be started, and the robot will completewithout an error. The browser will open.
Информация |
---|
Информация |
Эту ситуацию можно воспроизвести с любой папкой, у которой есть кириллица в пути. При этом не обязательно, чтобы сам пользователь был записан кириллицей Thissituationcan be replicatedwithanyfolderthathasCyrillic letters in the path.At the same time, it is notnecessarythattheuser himself bewritten in Cyrillic . |
Example of use
Task
Open the selected browser on the given page, get the action context for working with actions of the "Browsers" group.
...
- Open the "Browsers" action group
- Open the "Windows, tabs, frames" subgroup
- Add the "Open Browser" action to the workspace.
- Set the action parameters:
- "Browser" field. Select a browser from the drop-down list that you want to open.
- "Properties" field. Specify a JSON-formatted file using a template that will set the prioritized properties to launch the browser.
- "Explicitly wait" field. Set the timeout time to 1000ms.
- "Background mode" field. The value is "True" or "False". Leave "False" to open the browser in visible mode.
- "URL" field. Specify the URL that will be used to open the browser - https://ya.ru
- The "Save in" field. Specify the address on the PC where the downloaded files will be saved if the download link is specified in the "Address" parameter.
- Add the "Close browser" action to the workspace. Fill in the "Context" parameter.
- Launch the robot using the "Start" button in the top panel.
Result
The Edge browser was opened in visible mode, and the page was navigated to https://ya.ru