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