Просмотреть исходный

Параметры и их настройки

Свойство	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Браузер	Название браузера, к которому нужно подключиться. Возможные значения: CHROME (Chrome), YANDEX (Yandex).	Выпадающий список	Yandex	Да
Адрес	IP-адрес, к которому надо подключиться. Значение по умолчанию: localhost.	Строка	localhost	Нет
Порт	Порт, по которому проходит подключение. Значение по умолчанию: 9222.	Число	9222	Нет
Результаты
Контекст	Экземпляр браузера, с которым будут работать действия.	Экземпляр Selenium	-	-

Особые условия использования

Как работает подключение

Действие не запускает браузер. Оно подключает WebDriver к адресу, указанному в параметрах Адрес и Порт, определяет версию установленного браузера, подбирает совместимый драйвер и возвращает контекст браузера для следующих действий робота.

До запуска действия необходимо отдельно запустить браузер с портом удалённой отладки. Порт в команде запуска должен совпадать со значением параметра Порт. При работе на том же компьютере рекомендуется оставить адрес localhost.

В командах запуска параметр --user-data-dir задаёт каталог данных браузера. Это папка, в которой браузер хранит профили, настройки, cookies, историю, расширения и сведения о сессии. Для автоматизации используйте отдельный каталог данных, который не используется при обычном запуске браузера. Данные обычного профиля автоматически в него не копируются.

Настройка

Chrome

Начиная с Chrome 136 параметр --remote-debugging-port не работает со стандартным каталогом данных Chrome. Поэтому в команде запуска необходимо указать отдельный каталог данных с помощью параметра --user-data-dir.

Пример команды для Windows:

"C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222 --user-data-dir="C:\Robin\ChromeDebugProfile"

Яндекс Браузер

Пример команды для Windows:

"C:\Program Files\Yandex\YandexBrowser\Application\browser.exe" --remote-debugging-port=9222 --user-data-dir="C:\Robin\YandexDebugProfile" --profile-directory="Profile 1" about:blank

Правила настройки

Создайте отдельный каталог данных, например C:\Robin\YandexDebugProfile.
Перед выполнением команды закройте все экземпляры Яндекс Браузера, которые используют указанный каталог данных.
При необходимости замените в команде путь к browser.exe, путь к каталогу данных и имя профиля.
Выполните команду запуска.
Если роботу нужны сохранённая авторизация, cookies или заранее открытые страницы, после запуска подготовьте их в профиле автоматизации.
Откройте http://localhost:9222/json/version. Если порт настроен правильно, браузер вернёт сведения о версии и поле webSocketDebuggerUrl.
В действии укажите Браузер — Chrome/Yandex, Адрес — localhost, Порт — 9222.

Особенности Яндекс Браузера:

При запуске Яндекс Браузер последовательно загружает не более десяти восстановленных вкладок. Перед запуском робота дождитесь загрузки нужных страниц.
Используйте ROBIN 2.26.2 или новее. В более ранних версиях подключение могло зависнуть при наличии двух и более восстановленных вкладок. Если обновление недоступно, перед запуском робота последовательно откройте нужные вкладки или закрепите их.
Для автоматического запуска подготовьте профиль с минимальным количеством восстанавливаемых страниц. Не перезагружайте страницы с несохранёнными данными в формах.
Перед подключением оставьте хотя бы одну обычную вкладку.
После перезапуска браузера порядок и индексы вкладок могут измениться. Если используемая версия действия Переключиться на вкладку позволяет, выбирайте вкладку по URL или шаблону URL. Перед выполнением действия Перейти по URL в текущей вкладке явно переключитесь на нужную обычную вкладку.
В Яндекс Браузере для организаций администратор может отключить выгрузку неактивных вкладок политикой YandexDiscardUnusedTabs. Политика не гарантирует, что восстановленные вкладки загрузятся до подключения робота.

Связанные исправления работы с вкладками Яндекс Браузера выпущены в ROBIN 2.26.2. Если описанные проблемы воспроизводятся, сначала проверьте версию ROBIN и обновитесь до 2.26.2 или новее.

Дополнительные материалы

Общие правила

Используйте один порт только для одного запущенного экземпляра браузера.
Значения Адрес и Порт должны вести к тому экземпляру браузера, которым должен управлять робот.
Не запускайте второго робота с подключением к тому же окну браузера.
После перезапуска браузера получите новый контекст действием Подключиться к открытому браузеру. Не используйте контекст от завершённого экземпляра.

Исключения

№	Событие	Описание ошибки в логе
1	Не удалось определить установленную версию выбранного браузера.	`Версия браузера не определена. Браузер: {0} / {1}.`
2	Не удалось подобрать версию драйвера для выбранного браузера.	`Точная версия драйвера не найдена. Требуется драйвер для {0} / {1}. Укажите его в конфиг файле.`
3	Не найден исполняемый файл совместимого драйвера.	`Драйвер не найден. Требуется драйвер для {0} / {1}. Укажите его в конфиг файле.`
4	Не удалось запустить драйвер или подключить его к выбранному браузеру.	`Не удалось запустить браузер. Проверьте, правильно ли указаны драйвер и настройки браузера для {0} / {1}. Ошибка: {2}`
5	Драйвер не удалось извлечь из ресурсов ROBIN.	`Не удалось получить из ресурса драйвер {0}. Ошибка: {1}`

Значения {0}, {1} и {2} в логе заменяются фактическими сведениями о браузере, драйвере и причине ошибки.

Изменения в версии

В ROBIN 2.26.2 выпущены связанные исправления действий «Переключиться на вкладку» и «Перейти по URL» для сценариев Яндекс Браузера, включая выбор вкладки по URL и обработку скрытой вкладки chrome://wallpaper.