Клик на странице — документация 0.4

browser.click · Браузер

Ждёт элемент на странице и нажимает на него

Ждёт элемент на странице и нажимает на него: кнопку, ссылку, флажок, пункт меню. Перед нажатием браузер сам дожидается, пока элемент станет видимым, доступным и перестанет двигаться.

Свойства #

Свойство	Имя в файле	Значение	Обязательное	По умолчанию	Описание
Селектор	`selector`	селектор страницы	да	—	Селектор Playwright: CSS (#id, .class), text=Войти, xpath=//button, role=button[name="OK"]
Таймаут, мс	`timeoutMs`	число	нет	10000
Сессия	`session`	текст	нет	`main`	Имя сессии браузера (по умолчанию main); несколько сессий — несколько окон

Результат #

Действие не возвращает значений.

Как работает #

Селектор (selector) — селектор Playwright: CSS (#fio, .btn-primary, input[name="phone"]), текст (text=Войти), роль (role=button[name="Отправить"]), XPath (xpath=//table/tr[2]). Как найти селектор — Пикер элементов.
Таймаут, мс (timeoutMs, по умолчанию 10000) — сколько ждать, пока элемент появится и станет доступным.
Сессия (session, по умолчанию main) — имя окна браузера, открытого browser.open. Нужно, только если процесс работает с несколькими окнами сразу.
Если после клика загружается новая страница, следующий шаг (например, browser.waitElement) дождётся нужного элемента на ней.

Ошибки #

Код	Причина и что делать
`ElementNotFound`	Элемент не найден за время ожидания — проверьте селектор в инструментах разработчика браузера (F12) и что открыта нужная страница
`Timeout`	Элемент найден, но не стал доступным (скрыт, перекрыт, неактивен)
`InvalidArgument`	Селектор находит несколько элементов — уточните его (например, добавьте `>> nth=0`); селектор с ошибкой синтаксиса
`BrowserError`	Сессия не открыта (нет шага `browser.open` перед этим) или окно браузера закрыли

При ошибке робот сохраняет снимок страницы: в студии — ссылка «Открыть скриншот» в «Лог», в оркестраторе — на странице задания.

Пример #

{ "type": "browser.click", "displayName": "Отправить заявку", "props": { "selector": "#submit" } }