Документация 0.4 Справочник действий
Ввести текст на странице
browser.typeInto · Браузер
Вводит текст в поле на странице
Вводит текст в поле ввода на странице: ФИО, телефон, сумму, логин и пароль.
Свойства #
| Свойство | Имя в файле | Значение | Обязательное | По умолчанию | Описание |
|---|---|---|---|---|---|
| Селектор | selector |
селектор страницы | да | — | Селектор Playwright: CSS (#id, .class), text=Войти, xpath=//button, role=button[name="OK"] |
| Текст | text |
текст | да | — | |
| Очистить перед вводом | clearBefore |
да/нет | нет | да | |
| Таймаут, мс | timeoutMs |
число | нет | 10000 | |
| Сессия | session |
текст | нет | main |
Имя сессии браузера (по умолчанию main); несколько сессий — несколько окон |
Результат #
Действие не возвращает значений.
Как работает #
- Селектор (
selector) — селектор Playwright: CSS (#fio,.btn-primary,input[name="phone"]), текст (text=Войти), роль (role=button[name="Отправить"]), XPath (xpath=//table/tr[2]). Как найти селектор — Пикер элементов. Селектор должен указывать наinput,textareaили редактируемый элемент. - Текст (
text) — с подстановками{{ }}:{{ client['Телефон'] }}. - Очистить перед вводом (
clearBefore, включено) — заменить содержимое поля целиком. Выключено — курсор ставится в конец, текст печатается по символу (так срабатывают подсказки и маски ввода). - Таймаут, мс (
timeoutMs, по умолчанию 10000) — сколько ждать, пока элемент появится и станет доступным. - Сессия (
session, по умолчаниюmain) — имя окна браузера, открытогоbrowser.open. Нужно, только если процесс работает с несколькими окнами сразу.
Ошибки #
| Код | Причина и что делать |
|---|---|
ElementNotFound |
Элемент не найден за время ожидания — проверьте селектор в инструментах разработчика браузера (F12) и что открыта нужная страница |
Timeout |
Элемент найден, но не стал доступным (скрыт, перекрыт, неактивен) |
InvalidArgument |
Селектор находит несколько элементов — уточните его (например, добавьте >> nth=0); селектор с ошибкой синтаксиса |
BrowserError |
Сессия не открыта (нет шага browser.open перед этим) или окно браузера закрыли |
InvalidArgument |
Элемент не является полем ввода |
При ошибке робот сохраняет снимок страницы: в студии — ссылка «Открыть скриншот» в «Лог», в оркестраторе — на странице задания.
Пример #
{ "type": "browser.typeInto", "props": { "selector": "#fio", "text": "{{ fio }}", "clearBefore": true } }