Открыть браузер
Элемент выполняет 2 основные функции:
-
Открывает новый экземпляр браузера либо новую вкладку в уже открытом браузере. Примечание: в Internet Explorer всегда будет открываться только новый экземпляр.
-
Выступает в роли контейнера для других элементов, работающих с веб-страницами. Например, для таких, как Присутствие элемента, Клик мышью, Обновить страницу и т. д.
Элементы, вложенные в контейнер Открыть браузер и присоединенные к нему, требуют наличия расширения браузера, хотя сам контейнер работает независимо от него. Способы установки расширений описаны здесь.
Свойства
Символ *
в названии свойства указывает на обязательность заполнения. Описание общих свойств см. в разделе Свойства элемента.
WebDriver
- Порт [Int32] — Порт отладчика
- Путь к браузеру [String] — Путь к исполняемому файлу браузера
Браузер:
-
URL [String] — адрес страницы. Пример:
"https://primo-rpa.ru/"
. -
Аргументы запуска — строка аргументов для запуска браузера. Доступно с версии 1.24.10
-
Освобождать [Boolean] — определяет, следует ли освобождать ссылку на браузер при выходе. По умолчанию чекбокс выключен — ссылка не освобождается.
-
Скрывать [Boolean] — только при совместном использовании с WebDriver, кроме Edge. Определите, следует ли запускать браузер невидимым для пользователя - в фоновом режиме. По умолчанию чекбокс выключен.
-
Состояние загрузки — следует ли ждать загрузки веб-страницы, указанной в свойстве URL. Переход к первому элементу в контейнере будет осуществляться только при достижении указанного состояния загрузки страницы. Если страница не успеет загрузиться в установленный таймаут, робот завершит работу с ошибкой.
Значения параметра:
- None — не ждать загрузки страницы. Значение установлено по умолчанию и используется для обратной совместимости.
- Interactive — система будет ждать загрузки страницы и построения DOM-дерева, но дополнительные ресурсы могут продолжать загружаться. Например: изображения,
<iframe>
. - Complete — ждать полной загрузки страницы.
-
Таймаут* [Int32] — предельное время ожидания завершения процесса в миллисекундах. По умолчанию
50000
(50 сек). Таймаут не влияет на свойство Состояние загрузки, для которого выбрано значениеNone
. -
Тип браузера - тип используемого браузера. По умолчанию
IE
— Internet Explorer. Чтобы выбрать другое значение, кликните выпадающий список:Значения, которые начинаются со слов
Web Driver
, предназначены для тех случаев, когда необходимо использовать Selenium WebDriver. По умолчанию веб-драйвер уже встроен в Студию, но для успешной работы версии драйвера и браузера должны быть совместимы. Если они не совместимы, то веб-драйвер требуется обновить.
«Вывод»:
- Переменная [LTools.WebBrowser.BrowserInst] — здесь можно указать переменную для сохранения ссылки на подключенный браузер.
Решение проблем
Если использование элемента не привело к ожидаемому результату, проверьте:
- установлен в системе браузер, выбранный в свойстве Тип браузера;
- права доступа пользователя на использование браузера;
- описание ошибки в консоли.
Только код
Пример использования элемента в процессе с типом Только код (Pure code):
C#
LTools.WebBrowser.BrowserApp app =
LTools.WebBrowser.BrowserApp.Open(wf,
LTools.WebBrowser.Model.BrowserTypes.IE);