Действие парсера «Браузер: найти элемент»

Параметры действия:

Предназначение действия:

Находит нужный элемент на странице в браузере, и выполняет действие над найденным элементом.
Для ссылок (тег A) можно извлечь URL, или сразу же прогрузить страницу в текущей или отдельной вкладке.

Возвращаемое значение: зависит от выбранного действия

 


Параметр «Режим поиска»

Тип параметра: выбор из списка предопределенных значений

Допустимые значения параметра: TagName; ID; Name; ClassName; CssSelector; XPath; LinkText; PartialLinkText

Значение по умолчанию: ID

Поиск нужного тега возможен одним из следующих способов:


TagName Поиск по названию тега (input / div / a / span и т.п.)
ID Поиск по атрибуту ID (предпочтительный способ поиска, поскольку атрибут ID уникальный внутри страницы)
Name Поиск по атрибуту name (<input name="message">)
ClassName Поиск по атрибуту class (<div class="offers">)
CssSelector Поиск с использованием селектора CSS. Скопировать селектор можно в консоли браузера (Ctrl + Shift + I), щелкнув правой кнопкой на интересующем вас теге, и в контекстном меню выбрав Копировать — Копировать selector
XPath Поиск с использованием селектора Xpath. Скопировать селектор можно в консоли браузера (Ctrl + Shift + I), щелкнув правой кнопкой на интересующем вас теге, и в контекстном меню выбрав КопироватьКопировать XPath
LinkText Поиск по тексту ссылки (применяется только для поиска тега A)
ВНИМАНИЕ: важен регистр символов (если ссылка имеет текст «Контакты», то по тексту «контакты» она найдена не будет)
PartialLinkText Поиск по части текста ссылки (применяется только для поиска тега A)
Например, если надо щелкнуть по ссылке с текстом «Цены (25)», где для разных страниц число в скобках будет отличаться, то используется этот режим поиска (в параметре задаётся текст Цены)
ВНИМАНИЕ: важен регистр символов (если ссылка имеет текст «Цены», то по тексту «цены» она найдена не будет)

 

Параметр «Параметр поиска»

Тип параметра: произвольное текстовое значение

 

Параметр «Действие»

Тип параметра: выбор из списка предопределенных значений

Допустимые значения параметра: SetValue; SendKeys; SetAsTarget; Click; Click Repeat; Submit; Clear; GetOuterHTML; GetInnerHTML; GetText; GetAttribute; SetAttribute; DeleteAttribute; Link: GetURL; Link: Follow; Link: OpenInNewTab; Link: LoadInTemporaryTab; ExecuteScript; SelectByIndex; SelectByText; SelectByPartialText; SelectByValue; DeselectByIndex; DeselectByText; DeselectByValue; DeselectAll; Hide; Show; Delete; SetOuterHTML; SetInnerHTML; Mouse: MoveToElement; Mouse: ContextClick

Значение по умолчанию: SetValue

Действие позволяет считать информацию из найденного тега, или выполнить над ним какое-либо действие:


SetValue Задаёт значение для текстового поля, предварительно очищая его
(комбинация команд Clear и SendKeys)
Чаще всего используется для ввода логина и пароля в поля ввода.
SendKeys Отправляет заданный текст в найденное текстовое поле (SendKeys — отправка нажатий клавиш)
Если в поле уже присутствует текст, он не будет удалён
SetAsTarget

Запоминает текущий элемент, чтобы можно было выполнить поиск тегов внутри него.
После выполнения команды SetAsTarget, можно в следующем действии «Браузер: найти элемент» указать Область поиска равной «Element», и тогда поиск будет произведён внутри этого тега.

Кроме того, для помеченного таким способом элемента можно сделать скриншот

Click Выполняет щелчок мышью на найденном элементе (предварительно прокрутив страницу, если элемент находится вне видимой части страницы)
После этого программа ожидает готовности страницы, и после этого считывает (и возвращает) HTML код текущей страницы.
Click Repeat Выполняет щелчок на элементе (аналогично Click) до тех пор, пока элемент присутствует на странице.
Используется для повторных нажатий кнопки «Показать ещё» (до тех пор, пока все товары не будут показаны, и эта кнопка исчезнет)
Submit Выполняет отправку формы (применяется в элементу <input type="submit">)
Используется при авторизации, после заполнения полей логина и пароля.
Clear Очищает найденный элемент (текстовое поле) от текста.
GetOuterHTML Возвращает HTML код (OuterHTML) найденного тега
GetInnerHTML Возвращает HTML код содержимого (InnerHTML) найденного тега
GetText Возвращает текст найденного элемента
GetAttribute Возвращает значение атрибута, название которого указано в параметре
SetAttribute Задаёт / изменяет значение атрибута. Параметр должен иметь вид name=value
DeleteAttribute Удаляет атрибут, название которого указано в параметре
Link: GetURL Применяется только для тегов A (ссылка). Возвращает ссылку (URL)
Link: Follow Применяется только для тегов A (ссылка). Выполняет открытие ссылки в текущей вкладке (аналогично команде Click, только в этом случае гарантируется, что ссылка откроется именно в текущей вкладке.
Возвращает HTML код загруженной страницы.
Link: OpenInNewTab Применяется только для тегов A (ссылка). Выполняет открытие ссылки в новой вкладке.
Возвращает HTML код загруженной страницы.
Link: LoadInTemporaryTab Применяется только для тегов A (ссылка). Прогружает страницу во временной вкладке (ссылка открывается в новой вкладке, парсер ждёт пока страница прогрузится, считывает код страницы, и закрывает новую вкладку)
Возвращает HTML код загруженной страницы.
ExecuteScript Выполняет javascript для найденного элемента. Скрипт задаётся в параметре.
Например, скрипт return this.outerHTML вернёт HTML код элемента.
Возвращает результат выполнения скрипта.
SelectByIndex Позволяет выделить пункт в списке с множественным выбором.
В параметре задаётся ИНДЕКС выделяемого элемента.
SelectByText Позволяет выделить пункт в списке с множественным выбором.
В параметре задаётся ТЕКСТ выделяемого элемента.
ВАЖНО: регистр символов имеет значение!
SelectByPartialText Позволяет выделить пункт в списке с множественным выбором.
В параметре задаётся ЧАСТЬ ТЕКСТА выделяемого элемента.
(применяется, когда пункты имеют вид «Москва (255)», и число в скобках может меняться)
ВАЖНО: регистр символов имеет значение!
SelectByValue Позволяет выделить пункт в списке с множественным выбором.
В параметре задаётся ЗНАЧЕНИЕ (value) выделяемого элемента.
DeselectByIndex Отменяет выделение пункта в списке с множественным выбором.
В параметре задаётся ИНДЕКС нужного элемента списка.
DeselectByText Отменяет выделение пункта в списке с множественным выбором.
В параметре задаётся ТЕКСТ нужного элемента списка.
ВАЖНО: регистр символов имеет значение!
DeselectByValue Отменяет выделение пункта в списке с множественным выбором.
В параметре задаётся ЗНАЧЕНИЕ (value) нужного элемента списка.
DeselectAll Отменяет выделение пункта в списке с множественным выбором.
В параметре задаётся ИНДЕКС нужного элемента списка.
Hide Скрывает элемент на странице (может пригодиться при снятии скриншотов, когда нужно скрыть лишние элементы, чтобы они не попали на скриншот)
Аналогично выполнению команды ExecuteScript с параметром this.style.display = 'none'
Show Отображает найденный элемент, если он скрыт
Аналогично выполнению команды ExecuteScript с параметром this.style.display = ''
Delete Удаляет элемент со страницы
Аналогично выполнению команды ExecuteScript с параметром this.remove()
SetOuterHTML Позволяет изменить HTML код (OuterHTML) найденного тега. В параметре задаётся новый HTML код
SetInnerHTML Позволяет изменить HTML код содержимого (InnerHTML) найденного тега. В параметре задаётся новый HTML код
Mouse: MoveToElement Перемещает указатель мыши к найденному элементу
Mouse: ContextClick Выполняет вызов контекстного меню для найденного элемента (после чего можно действием «Браузер: клавиатура» отправить нажатия клавиш для выбора нужного пункта контекстного меню)

 

Параметр «Параметр действия»

Тип параметра: произвольное текстовое значение

 

Параметр «Область поиска»

Тип параметра: выбор из списка предопределенных значений

Допустимые значения параметра: Page; Element

Значение по умолчанию: Page

Определяет, где искать элемент, — на всей странице, или внутри ранее найденного тега.
ВНИМАНИЕ: если на странице есть несколько подходящих элементов, будет взят первый найденный.


Page Поиск элемента (тега) выполняется по всей странице
Element Поиск элемента (тега) выполняется внутри ранее найденного элемента, который был сохранён командой SetAsTarget 

 

Примеры использования:

Пример авторизации на сайте sports.ru:

Действие Параметр Значение
Браузер: открыть страницу URL https://www.sports.ru/
Режим загрузки ActiveTab
Режим ожидания  
Параметр ожидания  
если авторизация уже выполнена — пропускаем этот этап
Проверка на выполнение условия Режим проверки не содержит
Значение для сравнения logon.html
Действие при выполнении условия Пропустить несколько действий
Параметр действия 4
Проверять другое значение нет
Другое проверяемое значение  
Браузер: найти элемент
(ищем ссылку с текстом Вход)
Режим поиска LinkText
Параметр поиска Вход
Действие Click
Параметр действия  
Область поиска Page
Браузер: найти элемент
(ищем поле ввода логина)
Режим поиска Name
Параметр поиска login
Действие SetValue
Параметр действия email@mail.ru
Область поиска Page
Браузер: найти элемент
(ищем поле ввода пароля)
Режим поиска Name
Параметр поиска password
Действие SetValue
Параметр действия 123456
Область поиска Page
Браузер: найти элемент
(ищем тег <form class="auth__login">)
Режим поиска ClassName
Параметр поиска auth__login
Действие Submit
Параметр действия  
Область поиска Page
теперь можно загружать нужные страницы
Браузер: открыть страницу URL https://www.sports.ru/fantasy/football/italy/92026/
Режим загрузки ActiveTab
Режим ожидания  
Параметр ожидания