Работа с окнами, вкладками, фреймами браузера:

Открыть браузер / Open browser

Данное действие предназначено для открытия выбранного браузера. В момент открытия браузера создается контекст.

Настройки

Особые условия использования 

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

Т.е. подключиться к существующему инстансу браузера невозможно, будет создан новый.

После завершения работы робота с браузером, браузер автоматически не закрывается. Требуется использование действия Закрыть браузер.

Настройки параметров запускаемого браузера зависят от конкретного браузера.

Реализована возможность работы с несколькими открытыми браузерами в рамках одного сценария. 

Пока не использует OpenQA.Selenium.Html5

Подключение драйверов

Действие имеет в составе webpack с архивом драйверов для различных браузеров и их версий. 

С помощью системных утилит действие определяет версию браузера, установленную на машине пользователя.

Если пользователь указал браузер, который не установлен на его машине, то в лог будет выведен Error со следующим сообщением: "%Название браузера% отсутствует".

Если браузер установлен, то действие создает по шаблону путь к нужному драйверу, извлекает его из архива и кладет в каталог ресурсов агента. 

После этого действие запускает браузер, используя данный драйвер.

Если необходимого драйвера не нашлось в пакете, действие пытается получить путь к заданному индивидуально драйверу из конфигурационного сервиса движка. 

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

Если не удается получить драйвер из config файла, то будет произведена попытка использовать ближайший (ниже) по версии к версии браузера из имеющихся в пакете. 

При этом в лог будет выведен Warning или Error (если браузер крашится) в лог со следующим сообщением: "Требуется драйвер для %Название и версия браузера% . Укажите его в файле %Путь к конфиг-файлу% ".

Закрыть браузер / Close browser

Данное действие предназначено для закрытия браузера. В момент закрытия браузера закрывается контекст.

Настройки

Особые условия использования 

Отсутствуют.

Получить URL / Get active URL

Данное действие предназначено для получения URL текущей активной вкладки.

Настройки

Особые условия использования 

Отсутствуют.

Перейти по URL / Navigate to

Данное действие предназначено для перехода в рамках текущей вкладки по указанному URL.

Настройки

Особые условия использования 

Отсутствуют.

Обновить / Refresh

Данное действие предназначено для обновления текущей страницы. 

Система выполняет эмуляцию нажатия кнопки    в браузере.

Настройки

Особые условия использования 

Отсутствуют.

Вперед / Forward

Данное действие предназначено для навигации вперёд на странице. 

Система выполняет эмуляцию нажатия кнопки    в браузере.

Настройки

Особые условия использования 

Отсутствуют.

Назад / Back

Данное действие предназначено для навигации назад на странице. 

Система выполняет эмуляцию нажатия кнопки  в браузере.

Настройки

Особые условия использования 

Отсутствуют.

Переключиться на вкладку / Switch to tab

Данное действие предназначена для переключения фокуса на выбранную вкладку среди уже открытых.

Настройки

Особые условия использования 

Нумерация вкладок производится в порядке открытия и не зависит от последующего перемещения вкладок в браузере, но всегда соответствует их текущему количеству. Т.е. после удаления 4-й вкладки из 5, 5-я станет 4-й.

Сравнение текста при выборе вкладки регистронезависимо.

Закрыть вкладку /  Close tab

Данное действие предназначена для закрытия выбранной вкладки.

Настройки

Особые условия использования 

Нумерация вкладок производится в порядке открытия и не зависит от последующего перемещения вкладок в браузере, но всегда соответствует их текущему количеству. Т.е. после удаления 4-й вкладки из 5, 5-я станет 4-й.

Сравнение текста при выборе вкладки регистронезависимо.

Если вкладка единственная - Система закрывает браузер.

Переключиться на фрейм / Switch to frame

Данное действие предназначена для переключения фокуса на выбранный фрейм.

Настройки

Особые условия использования 

При работе с элементами страницы элементы фрейма недоступны. Для того, чтобы обратиться к элементам фрейма, на него необходимо переключиться.

При работе с элементами фрейма  элементы страницы недоступны. Для того, чтобы продолжить работу с элементами страницы, необходимо переключиться с фрейма обратно на страницу.

Повторно перейти на текущую вкладку возможно также с помощью действия "Переключиться на вкладку".

Выполнить скрипт / Execute script

Данное действие предназначено для выполнения скрипта в браузере. (JavascriptExecutor)

Настройки

Особые условия использования

Отсутствуют.

Работа с элементами и свойствами: 

Получить текст / Get text (GetElementText)

Данное действие предназначено для получения текста выбранного элемента.

Настройки

Особые условия использования 

Отсутствуют.

Получить список элементов / Get elements (GetElementList)

Данное действие предназначено для получения коллекции всех элементов, удовлетворяющих заданным условиям, в переменную.

Настройки

Особые условия использования

Так как количество элементов можно подсчитать, специализированного действия "Подсчет элементов" нет.

Получить атрибут элемента / Get element attribute (GetElementAttribute)

Получает значение указанного атрибута элемента. 

Настройки

Особые условия использования

Для чек-бокса и радиокнопки атрибут checked  определяет состояние активации.

Для списка и комбо-бокса атрибут атрибут selected  элемента option определяет состояние активации .

Для элементов типа input (text) и text area значение атрибута value определяет текстовое содержимое.

Установить атрибут элемента /  Set element attribute 

Устанавливает значение указанного атрибута элемента. 

Настройки

Особые условия использования

Для активации чек-бокса и радиокнопки необходимо присвоить атрибуту checked значение true.

Для активации option необходимо присвоить атрибуту selected значение true.

Для элементов типа input (text) и text area значение атрибута value определяет текстовое содержимое.

Получить стиль элемента / Get element style property 

Получает значение указанного свойства стиля элемента. 

Настройки

Особые условия использования

Отсутствуют.

Установить стиль элемента / Set element style property 

Устанавливает значение для указанного свойства стиля элемента.

Настройки

Особые условия использования

Отсутствуют.

Получить значение списка / Get list value 

Получает для типа элемента Select выбранные в списке опции.

Настройки

Особые условия использования 

Получает информацию об одной опции, если атрибут multiple не установлен, и о нескольких, если установлен.

Если "Внутренние значения" не установлено, то выбирается видимый текст, если установлено, то выбираются внутренние значения (атрибут value тега option).

Установить значение списка / Set list value 

Устанавливает для прокручиваемого или выпадающего списка (элемент Select) выбранные в списке опции.

Настройки

Особые условия использования 

Устанавливает значение для одной опции, если атрибут multiple не установлен (прокручиваемый список), и для нескольких, если установлен (выпадающий список).

Если в параметр Коллекция опций будет передано пустая коллекция, будет сброшен выбор всех опций.

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

Если "Внутренние значения" не установлено, то поиск опций идет по видимому тексту, если установлено, то по внутренним значениям (атрибут value тега option).

Для комбобокса параметр "Добавить" не играет значение. 

Получить размер и координаты элемента / Get element size and coordinates 

Данное действие предназначено для получения получения координат и размеров элемента. 

Настройки

Особые условия использования

Отсутствуют.

Проверка наличия элемента / Check element existing 

Данное действие предназначено для проверки существования элемента на странице по завершению тайм-аута. 

Настройки

Особые условия использования

Видимый и доступный элемент является кликабельным.

Получить внутренний ID / Get element internal Id 

Данное действие предназначено для получения внутреннего ID элемента. 

Настройки

Особые условия использования

Отсутствуют.

Получить таблицу / Get table

Данное действие предназначено для получения таблицы в переменную.

Настройки

Особые условия использования 

Действие применимо только для элементов с типом table.

Работа с мышью и клавиатурой:

Отправить клик / Send click 

Эмулирует нажатие кнопки мыши на элементе страницы с возможностью эмуляции зажатой клавиши (клавиш) клавиатуры.

Настройки

Особые условия использования 

Если элемент находится вне зоны видимости, будет совершена прокрутка к нему.

Отправить текст / Send text 

Эмулирует ввод текста в указанный элемент.

Настройки

Особые условия использования 

Фокус для ввода текста устанавливается кликом и переход к концу текста осуществляется нажатием клавиш Ctrl+End (зашито в действие).

Т.е. текст всегда добавляется в конец, а не заменяется (даже для JavaScript новое значение добавляется к существующему).

Если элемент находится вне зоны видимости, будет совершена прокрутка к нему.

Отправить нажатие горячих клавиш / Send hot keys  

Эмулирует нажатие горячих клавиш на странице на странице браузера.

Настройки

Особые условия использования 

Можно отправить нажатие напрямую в браузер.

Если элемент находится вне зоны видимости, будет совершена прокрутка к нему.

Прокрутить к элементу  / Scroll to element 

Прокручивает видимую область страницы  для перемещения курсора на указанный элемент.

Настройки

Особые условия использования 

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

Смещения не работают внутри вложенных элементов.

Переместить указатель мыши / Move pointer 

Эмулирует наведение указателя мыши на выбранный  элемент.

Настройки

Особые условия использования 

Работает только в пределах видимой области. 

Работа диалоговыми окнами:

Получить текст окна диалога / Gets the text of the alert 

Данное действие предназначено для получения текста активного окна диалога. (IAlert )

Настройки

Особые условия использования

Отсутствуют.

Принять окно диалога / Accept the alert

Данное действие предназначено для имитации согласия с окном диалога. (IConfirm)

Настройки

Особые условия использования

Отсутствуют.

Отклонить окно диалога / Dismiss the alert

Данное действие предназначено для имитации несогласия с окном диалога. (IConfirm)

Настройки

Особые условия использования

Отсутствуют.

Ввести текст в окно диалога / Send text to the alert

Данное действие предназначено для ввода текста в окно диалога. (IPromt)

Настройки

Особые условия использования

Отсутствуют.

Ожидания:

Ждать значения атрибута / Wait for attribute value 

Данное действие предназначено для проверки состояния выбора элемента элемента по завершению тайм-аута в зависимости от переданного параметра. 

Настройки

Особые условия использования

Отсутствуют.

Ждать значение стиля / Wait for style value 

Данное действие предназначено для проверки состояния выбора элемента элемента по завершению тайм-аута в зависимости от переданного параметра. 

Настройки

Особые условия использования

Отсутствуют.

Ждать текст элемента  / Wait for element text 

Данное действие предназначено для проверки существования текста в элементе по завершению тайм-аута. 

Настройки

Особые условия использования

Сравнение текста регистронезависимо.

Ждать заголовок страницы  / Wait for page title 

Данное действие предназначено для проверки существования текста в элементе по завершению тайм-аута. 

Настройки

Особые условия использования

Сравнение текста регистронезависимо.

Ждать состояния элемента / Wait for element to exist 

Данное действие предназначено для проверки существования элемента на странице по завершению тайм-аута. 

Настройки

Особые условия использования

Видимый и доступный элемент является кликабельным.

Ждать исчезновения элемента / Wait for element staleness  

Данное действие предназначено для проверки факта того, что элемент отсутствует в DOM по завершению тайм-аута. 

Настройки

Особые условия использования

Отсутствуют.

Ждать окончания загрузки файла/Wait for the file to finish downloading

Группа действий: Браузеры 

Действие скачивает файл со страницы браузера и ожидает окончания его полной загрузки.

Настройки

File name

Folder path

Особые условия использования

Отсутствуют