Документация 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" } }