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