Загрузка страниц с помощью браузера Chrome

Важно! Плагин работает только с установленной последней версией Google Chrome.

Для реализации своих функций плагин задействует браузер Chrome. При запуске кампании Datacol откроет один или более экземпляров браузера Chrome. Количество работающих экземпляров Chrome равно количеству потоков кампании. Обратите внимание, что инициализация экземпляров браузеров может занять некоторое время.

Сценарий заключается в теги scenario. Таким образом, конфигурация может выглядеть следующим образом:



1



Команды заключаются в блоки, которых может быть несколько в рамках сценария. Каждый блок ограничивается тегами cblock.

Команда представляет собой отдельное пользовательское действие. Это может быть клик мышкой по кнопке, набор определенного текста в поле ввода, ожидание загрузки определенного вебэлемента и т.п. Каждая команда ограничивается тегами command.




ОПИСАНИЕ_КОМАНДЫ



ОПИСАНИЕ_КОМАНДЫ




Описание команды состоит из комментария, типа команды и набора параметров.




ТИП_КОМАНДЫ ЗНАЧЕНИЕ_ПАРАМЕТРА ЗНАЧЕНИЕ_ПАРАМЕТРА ЗНАЧЕНИЕ_ПАРАМЕТРА


Комментарий — это произвольный текст, описывающий смысл текущей команды для пользователя. Его можно использовать как напоминание для себя же, чтобы в будущем быстро понимать зачем та или иная команда присутствует в сценарии. Комментарий можно не использовать.

Тип команды задается в теге type и указывает собственно вид пользовательского действия. Ниже перечислены возможные значения типа команды:

• elementClick — клик по элементу, xpath-адрес которого указан в параметре xpath команды;
• elemNeededClick — клик по элементу, xpath-адрес которого указан в параметре xpath команды, а исходный код элемента соответствует регулярному выражению, указанному в параметре regex команды;
• elementTypeText — набор текста в элементе, xpath-адрес которого указан в параметре xpath команды. Текст указывается в параметре text команды;
• elementTypeTextAlt — набор текста в элементе, xpath-адрес которого указан в параметре xpath команды. Текст указывается в параметре text команды. При этом используется альтернативная технология набора текста. В ряде случаев работает команда elementTypeText, в других — elementTypeTextAlt. Таким образом, если не работает первая — пробуем использовать вторую;
• executeJS — выполнение яваскрипта, указанного в параметре script команды;
• waitElementLoaded — ожидание загрузки вебэлемента страницы, xpath-адрес которого указан в параметре xpath команды. Максимальное время ожидания загрузки вебэлемента (в секундах) указывается в параметре seconds команды;
• waitNElementsLoaded — ожидание загрузки определенного количества вебэлементов страницы, xpath-адрес которых указан в параметре xpath команды. Количество задается в параметре n команды. Максимальное время ожидания загрузки вебэлемента (в секундах) указано в параметре seconds команды;
• navigate — загрузка вебстраницы, адрес которой указан в параметре url команды. Если в виде значения параметра url указана метастрока %URL%, то происходит загрузка текущей вебстраницы, для которой работает плагин. Это зачастую используется в случаях, когда после авторизации сайт осуществляет редирект и нам необходимо повторно (уже от имени авторизованного пользователя) загрузить вебстраницу.

Каждый параметр команды задается в нижеприведенной конструкции:
ЗНАЧЕНИЕ_ПАРАМЕТРА

Ниже перечислены допустимые значения названия параметра (аттрибута name):

• xpath
• regex
• id
• text
• script
• url
• seconds
• n

Значения параметров зависят от конкретных команд, в которых они используются (описаны выше).

Обычно блок сценария выполняется только при определенных условиях. Например, когда пользователь еще не авторизован на сайте в данном конкретном экземпляре браузера (чтобы браузер не пытался авторизоваться при загрузке каждой страницы, в частности — когда авторизация уже осуществлена ранее). В таком случае нам нужно иметь возможность задать условие при выполнении которого блок будет выполнен. Это делается с помощью конструкции condition. Конструкция condition (если она присутствует) задается в начале блока. Каждый блок может иметь свою condition, но в одном блоке должна присутствовать только одна инструкция condition.




ОПИСАНИЕ_УСЛОВИЯ



ОПИСАНИЕ_КОМАНДЫ




Описание условия состоит из типа условия и набора параметров.

Тип условия задается в теге ctype и указывает собственно тип условия. Ниже перечислены возможные значения типа условия:

• elementExists — текущий блок команд будет выполнен если на странице присутствует элемент, xpath-адрес которого указан в параметре xpath условия;
• regexExists — текущий блок команд будет выполнен если на странице присутствует элемент, исходный код которого соответствует регулярному выражению, указанному в параметре regex условия;
• elementNotExists — текущий блок команд будет выполнен если на странице отсутствует элемент, xpath-адрес которого указан в параметре xpath условия;
• regexNotExists — текущий блок команд будет выполнен если на странице отсутствует элемент, исходный код которого соответствует регулярному выражению, указанному в параметре regex условия;

Каждый параметр условия задается в нижеприведенной конструкции:
ЗНАЧЕНИЕ_ПАРАМЕТРА

Ниже перечислены допустимые значения названия параметра (аттрибута name):

• xpath
• regex

Значения параметров зависят от конкретных условий, в которых они используются (описаны выше).

Рассмотрим простой сценарий:






elementTypeText //input[@name="target"] текст для ввода

СЛЕДУЮЩАЯ _КОМАНДА


СЛЕДУЮЩАЯ _КОМАНДА





В данном случае после загрузки страницы браузер попытается автоматически найти элемент с xpath-адресом //input[@name=»target»] . При данном написании сценария, даже если такой элемент не был найден, сценарий все равно продолжит выполняться. Однако чаще всего, если элемент (который используется командой) не находится, сценарий априори не может быть выполнен корректно. Например, если нам нужно авторизоваться, а форма авторизации отсутствует (или пользователь просто-напросто неверно задал xpath-адрес ее элемента в сценарии).

Чтобы команда в случае отсутствия нужного элемента (либо вообще в случае какой либо ошибки) сразу прерывала выполнение сценария, используйте в команде флаг detectErrors. Он указывается в каждой команде, которая должна прерывать сценарий в случае неуспешного выполнения. Вышеприведенный сценарий с detectErrors будет выглядеть следующим образом:







elementTypeText //input[@name="target"] текст для ввода

СЛЕДУЮЩАЯ _КОМАНДА


СЛЕДУЮЩАЯ _КОМАНДА





Обратите внимание, что при прерывании сценария и сигнализации ошибки, в результате страница в Datacol будет загружена с ошибкой. Ошибку можно будет просмотреть в логах работы кампании (или логе тестирования). Сигнализация об ошибке дает возможность пользователю в будущем подкорректировать сценарий для правильной работы.

кликните на изображении для увеличения

Рассмотрим использование сценариев на примере простого сценария для авторизации ВКонтакте.