Документация 0.4 Справочник действий
Открыть браузер
browser.open · Браузер
Запускает установленный Edge или Chrome и открывает страницу
Запускает браузер — установленный Microsoft Edge или Google Chrome — и открывает страницу. С этого шага начинается любая работа с сайтом; все остальные действия „Браузер“ работают в открытом им окне (сессии). Когда запуск процесса заканчивается, браузер закрывается сам.
Свойства #
| Свойство | Имя в файле | Значение | Обязательное | По умолчанию | Описание |
|---|---|---|---|---|---|
| Браузер | browser |
выбор из списка | нет | msedge |
Значения: msedge, chrome. |
| Адрес | url |
текст | нет | — | URL (https://…) или путь к файлу .html относительно папки flow |
| Без окна (headless) | headless |
да/нет | нет | нет | |
| Папка профиля | userDataDir |
путь к файлу | нет | — | Необязательно: постоянный профиль браузера (cookies и вход на сайты сохраняются между запусками) |
| Таймаут загрузки, мс | timeoutMs |
число | нет | 30000 | |
| Сессия | session |
текст | нет | main |
Имя сессии браузера (по умолчанию main); несколько сессий — несколько окон |
Результат #
Действие не возвращает значений.
Как работает #
- Браузер (
browser):msedge(по умолчанию, есть в Windows) илиchrome. Браузер не скачивается — нужен установленный. - Адрес (
url) —https://…или путь к файлу.html(относительный считается от папки процесса). Можно оставить пустым и открыть страницу позже шагомbrowser.navigate. Шаг ждёт загрузки страницы. - Без окна (headless) (
headless) — браузер работает невидимо; быстрее и не мешает человеку за компьютером. Для отладки оставьте выключенным, чтобы видеть, что делает робот. - Папка профиля (
userDataDir) — постоянный профиль браузера: cookies и вход на сайты сохраняются между запусками. Пусто — каждый запуск с чистым профилем. Профиль нельзя открыть одновременно в двух окнах. - Таймаут загрузки, мс (
timeoutMs, по умолчанию 30000) — сколько ждать загрузки страницы. - Сессия (
session, по умолчаниюmain) — имя окна браузера, открытогоbrowser.open. Нужно, только если процесс работает с несколькими окнами сразу. Сессию с тем же именем нельзя открыть дважды — сначалаbrowser.close.
Ошибки #
| Код | Причина и что делать |
|---|---|
BrowserError |
Браузер не установлен („Не найден Microsoft Edge…“ — выберите другой или установите), не запустился, профиль уже открыт в другом окне, страница не открылась (нет сети, неверный адрес сайта) |
Timeout |
Страница не загрузилась за время ожидания |
InvalidArgument |
Адрес без http:///https:// и не путь к существующему файлу; сессия с этим именем уже открыта |
Если страница не открылась, окно браузера закрывается: шаг можно повторить.
Пример #
{ "type": "browser.open", "props": { "browser": "msedge", "url": "../web/form.html", "headless": "{{ headless }}" } }