Оглавление
Описание
Данный экшен служит для получения значения указанного элемента. Это может быть:
Высота\ширина
Внутренний текст\HTML код
HTML атрибуты - id, class, name, style и др.
Имя тэга
И многое другое
Как добавить действие в проект?
Через контекстное меню Добавить действие → Табы → Получение значения
Через конструктор действий.
Либо воспользуйтесь умным поиском.
Как выбрать элемент для взятия значения?
Рассмотрим на примере https://lessons.zennolab.com/ru/registration. Представим, что Вам нужно получить текст кнопки, которая отправляет форму. Для этого делаем клик ПКМ по этой кнопке, из контекстного меню выбираем В конструктор действий.
Внизу, под окном браузера откроется Конструктор действий
Данные для поиска будут автоматически подобраны таким образом, что в результате поиска останется только один элемент. Ваши действия
В пункте Действие выбрать Get(1) (получить).
Текст кнопки хранится в атрибуте value поэтому именно его и выбираем из выпадающего списка Атрибут(2). В поле Значение появится то, что хранится в выбранном атрибуте(2), в нашем случае - это текст “Создать аккаунт”.
Перед добавлением экшена в проект не лишним будет протестировать его работу нажав соответствующую кнопку (особенно если Вы вносили изменения в конструкторе действий).
(Необязательно, но желательно) Добавить комментарий к экшену (особенно это касается экшена Получение значения т.к. комментарий по умолчанию крайне малоинформативен)
Добавляем экшен в проект клинув кнопку Добавить в проект
Для чего это используется?
Парсинг данных (правда для этого существует более подходящий инструмент - экшен Парсить страницу)
Проверка наличия элемента на странице. Это может быть полезно для:
определения того авторизовались ли мы (например, когда пользователь авторизован на сайте, то появляется кнопка перехода в личный кабинет, если она есть, значит всё ОК. Либо наоборот, когда пользователь авторизован, то пропадает какой-то элемент, как вариант - кнопка “Вход”, если её нет, значит мы вошли на сайт)
поиск сообщений с ошибками (очень полезно при разгадывании капчи: если капча была разгадана неверно, то очень часто на странице появляется новый HTML элемент с текстом ошибки; если после отправки капчи возвращается страница с таким элементом, то мы пробуем разгадать капчу ещё раз. Так же для проверки наличия текста на странице можно воспользоваться специальным экшеном Проверка наличия текста )
Проверка видимости элемента: бывают случаи, когда шаблон находит элемент, но по факту тот не отображается на странице (особенности построения HTML страниц), например это кнопка регистрации. Чтоб точно проверить отображена ли она на странице можно взять её атрибуты height (высота) и width (ширина), и проверить, чтоб каждый из них был больше 0.
Настройка действия: Вкладка “Основные”
После добавление экшена через конструктор действий в проект, откроем его настройки:
Что брать
Выбираем что именно нужно получить - id, class, innerText, innerHtml, value, height, width, style и др.
В данном поле можно и вручную указать значение, а не выбирать из предложенного.
На сайтах часто можно встретить атрибуты data-... (примеры - data-name, data-value, data-testid, data-whatever, ...)вот такие атрибуты (которых нет в выпадающем списке экшена) можно прописать вручную.
Можно использовать переменные проекта ({-Variable.var_name-})
Поиск элемента
Пожалуйста, ознакомьтесь с Правилами использования материалов на данном ресурсе
Прежде чем провзаимодействовать с элементом на странице его надо найти. В экшенах Получение значения , Установка значения , Выполнить событие , Событие Touch , Событие Swipe существует два способа поиска элементов - классический и с помощью XPath.
Классический - Поиск по параметрам HTML элемента: тэг, атрибут и его значение.
XPath - поиск с помощью XPath выражений. С помощью него Вы можете реализовать более универсальный и устойчивый к изменениям вёрстки способ поиска данных в сравнении с классическим поиском или регулярными выражениями.
Какая вкладка
Выбираем вкладку, на которой будет производиться поиск элемента.
Возможные значения:
Активная вкладка
Первая
По имени - при выборе данного пункта появится поле ввода для названия вкладки.
По номеру - в поле ввода надо будет ввести порядковый номер вкладки (нумерация начинается с нуля!)
Документ
Рекомендуется ставить значение -1 (поиск во всех документах на странице).
Форма
Тоже лучше ставить -1 (поиск по всем формам на странице). При выборе такого значения шаблон будет более универсальным.
В настройках программы можно отметить два чекбокса - Искать во всех формах на странице и Искать во всех документах на странице и тогда всегда при добавлении элемента в Конструктор действий для номера документа и формы будет стоять -1.
Тэг (только классический поиск)
Собственно HTML тэг у которого нужно получить значение.
Можно указать сразу несколько тегов, разделитель - ; (точка с запятой)
Условия (только классический поиск)
Группа - приоритет данного условия. Чем выше это число тем приоритет ниже. Если не смогли найти элемент по условию с наивысшим приоритетом, то переходим к условию со следующим приоритетом и так пока элемент не будет найден, либо пока не закончатся условия поиска. Можно добавлять несколько условий с одним приоритетом, тогда поиск будет производиться по всем условиям с одинаковым приоритетом одновременно.
Атрибут - атрибут HTML тэга по которому производится поиск.
Тип поиска:
text - поиск по полному либо частичному вхождению текста;
notext - поиск элементов в которых не будет указанного текста;
regexp - поиск с помощью регулярных выражений
По умолчанию поиск регистронезависимый. Чтобы при поиске с помощью регулярного выражения учитывался регистр добавьте в самом начале выражения(?-i)(это означает отключение регистронезависимого поиска)
Значение - значение атрибута HTML тега
№ совпадения - порядковый номер найденного элемента (нумерация с нуля!). В этом поле можно использовать диапазоны и макросы переменных.
Чтобы удалить условие поиска необходимо кликнуть ЛКМ по полю слева от него (на скриншоте выделено синим цветом) и нажать кнопку delete на клавиатуре.
Для поиска нужного элемента может использоваться несколько условий.
Всегда важно стараться подбирать условия поиска таким образом, чтоб оставался только один элемент, т.е. порядковый номер был 0 (нумерация с нуля).
Настройка действия: Вкладка “Дополнительно”
Подождать перед выполнением
Сколько времени экшен будет ожидать перед выполнением.
Ждать элемент не более
Если по истечении указанного времени элемент не появился на странице, то экшен завершит работу с ошибкой.
Пример использования
Разберём один из способов применения. На примере https://lessons.zennolab.com/ru/advanced.
С помощью Установки значений и переменных профиля заполняем поля формы. В реальном проекте нам бы пришлось распознавать капчу с помощью сервисов или вручную, но на данной странице капча-картинка всегда одна и та же. После ввода всех данных, с помощью экшена Выполнить событие, кликаем по кнопке Создать аккаунт. Далее события могут развиваться в нескольких направлениях:
Если мы всё верно заполнили и правильно разгадали капчу, то получим страницу, где будет текст Wellcome!
Если капча разгадана неверно, то загрузится странице с текстом wrong captcha
Используя конструктор действий создаём экшен Взятия значения, в который сохраняется текст, показанный на скриншотах выше. Но в переменную попадает много лишнего - текст adv_reg, названия пунктов меню. Используя Обработку текста и простое регулярное выражение (Wellcome!|wrong\ captcha) ищем либо Welcome либо wrong captcha. С помощью Switch делаем проверку на то, что содержится в переменной. Если там Welcome, то отправляем информационное сообщение в лог; если wrong captcha - отправляем сообщение в лог о том, что не удалось зарегистрироваться