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

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

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

Image Removed

Настройки

...

Браузер, который необходимо открыть.

По умолчанию Chrome.

Выпадающий список:

• Chrome
• Яндекс
• Firefox
• Internet Explorer
• Edge (chromium)

...

Chrome

...

Нет

...

Расширенные настройки

...

Список свойств браузера и их значений, которые будут установлены при запуске браузера.

В JSON формате, описывающий список свойств браузера и их значений, которые будут установлены при запуске.

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

Подключить расширения и задать профиль можно через этот параметр

Robin.String

...

Открытие в невидимом режиме.

Internet Explorer не поддерживает данную настройку

...

Значение для Тайм-аут

(Время явного ожидания)

...

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

Измеряется в миллисекундах.

...

URL, по которому должен быть выполнен переход если в параметре "Тип страницы" было выбрано значение "Заданная страница".

Поле будет доступно к заполнению после выбора значения "Заданная страница" в параметре "Тип страницы".

...

Контекст открытого сеанса работы с браузером, к которому будут обращаться дальнейшие действия.

Экземпляр браузера, с которым будет работать Selenium.

...

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Image Removed

Настройки

...

Контекст открытого сеанса работы с браузером.

...

ACTION_CONTEXT

...

Да

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

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

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

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

Image Removed

Настройки

...

Контекст открытого сеанса работы с браузером.

...

ACTION_CONTEXT

...

Да

...

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

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

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

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

Image Removed

Настройки

...

Контекст открытого сеанса работы с браузером.

...

ACTION_CONTEXT

...

Да

...

URL страницы, на которую будет совершен переход.

Если адрес содержит некорректные символы, то действие завершится ошибкой.

...

Открыть в новой вкладке.

...

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

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

Обновить / Refresh

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

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

Image Removed

Настройки

...

Контекст открытого сеанса работы с браузером.

...

ACTION_CONTEXT

...

Да

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

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

Вперед / Forward

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

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

Image Removed

Настройки

...

Контекст открытого сеанса работы с браузером.

...

ACTION_CONTEXT

...

Да

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

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

Назад / Back

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

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

Image Removed

Настройки

...

Контекст открытого сеанса работы с браузером.

...

ACTION_CONTEXT

...

Да

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

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

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

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

Image Removed

Настройки

...

Контекст открытого сеанса работы с браузером.

...

ACTION_CONTEXT

...

Да

...

Порядковый номер вкладки.

Если заполнен, имеет приоритет над параметром "Заголовок".

...

Название вкладки.

...

Вариант совпадения названия нужной вкладки с текстом из параметра "Заголовок".

Выпадающий список:

• Строгое - название вкладки равно параметру "Заголовок"
• Не строгое - название вкладки содержит текст из параметра "Заголовок"
• Регулярное выражение - название вкладки удовлетворяет регулярному выражению в параметре "Заголовок"

По умолчанию - "Не строгое"

...

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

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

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

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

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

Image Removed

Настройки

...

Контекст открытого сеанса работы с браузером.

...

ACTION_CONTEXT

...

Да

...

Порядковый номер вкладки.

Если заполнен, имеет приоритет над параметром "Заголовок".

...

Название вкладки.

...

Вариант совпадения названия нужной вкладки с текстом из параметра "Заголовок".

Выпадающий список:

• Строгое - название вкладки равно параметру "Заголовок"
• Не строгое - название вкладки содержит текст из параметра "Заголовок"
• Регулярное выражение - название вкладки удовлетворяет регулярному выражению в параметре "Заголовок"

По умолчанию - "Не строгое"

...

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

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

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

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

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

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

Image Removed

Настройки

...

Контекст открытого сеанса работы с браузером.

...

ACTION_CONTEXT

...

Да

...

Элемент для взаимодействия.

Если поле не заполнено - переход в главное окно.

Если поле не заполнено - переход в главное окно.

Если заполнено - попытка поиска элемента (фрейма) и переключения на него.

...

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

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

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

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

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

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

Image Removed

Настройки

...

Контекст открытого сеанса работы с браузером.

...

Robin.Selenium

ACTION_CONTEXT

...

Да

...

Результат выполнения.

...

Robin.Object

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

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

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

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

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

Image Removed

Настройки

...

Контекст открытого сеанса работы с браузером.

...

ACTION_CONTEXT

...

Да

...

Все текстовое содержимое

...

Получить все текстовое содержимое.

По умолчанию только видимый текст.

...

Удалять лишние пробелы и пробельные символы.

Все пробельные символы (пробел, табуляция, разрыв строки etc.) заменяются на пробел.

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

Все пробелы в конце и начале строки удаляются.

...

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

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

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

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

Image Removed

Настройки

...

Контекст открытого сеанса работы с браузером.

...

ACTION_CONTEXT

...

Элемент для поиска

Если XPath не найден, то действие завершится пустая коллекция.

...

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

...

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

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

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

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

Image Removed

Настройки

...

Контекст открытого сеанса работы с браузером.

...

Robin.Selenium

ACTION_CONTEXT

...

Да

...

Выберите имя атрибута, значение которого нужно узнать.

Выпадающий список:

• Тип - tagName
• Значение - value
• Содержимое - innerHTML
• Текстовое содержимое - innerText
• Текстовый контент - textContent
• Отмеченное состояние - checked
• Выбранное состояние - selected
• другое

...

Переменная, содержащая значение атрибута элемента.

...

Robin.Object

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

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

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

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

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

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

Image Removed

Настройки

...

Контекст открытого сеанса работы с браузером.

...

Robin.Selenium

ACTION_CONTEXT

...

Да

...

Имя атрибута, значение которого нужно установить.

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

Выпадающий список:

• Тип - tagName
• Значение - value
• Содержимое - innerHTML
• Текстовое содержимое - innerText
• Текстовый контент - textContent
• Отмеченное состояние - checked
• Выбранное состояние - selected
• другое

...

Значение атрибута, которое нужно установить.

Если поле не заполнено, будет установлено пустое значение или false для логических.

...

Robin.Object

...

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

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

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

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

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

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

Image Removed

Настройки

...

Контекст открытого сеанса работы с браузером.

...

Robin.Selenium

ACTION_CONTEXT

...

Да

...

Строковая переменная, содержащая значение свойства стиля элемента.

...

Robin.Object

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

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

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

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

Image Removed

Настройки

...

Контекст открытого сеанса работы с браузером.

...

Robin.Selenium

ACTION_CONTEXT

...

Да

...

Значение свойства стиля.

При пустом значении свойство будет очищено.

...

Robin.Object

...

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

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

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

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

Image Removed

Настройки

...

Контекст открытого сеанса работы с браузером.

...

ACTION_CONTEXT

...

Да

...

Выбрать в результирующую коллекцию внутренние значения списка.

...

true

...

Удалять лишние пробелы и пробельные символы.

Все пробельные символы (пробел, табуляция, разрыв строки etc.) заменяются на пробел.

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

Все пробелы в конце и начале строки удаляются.

...

Коллекция выбранных в списке опций.

...

Robin.Collection

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

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

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

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

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

Image Removed

Настройки

...

Контекст открытого сеанса работы с браузером.

...

ACTION_CONTEXT

...

Да

...

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

...

Использовать передаваемые значения, как внутренние значения списка.

...

true

...

Указанные значения будут добавлены к уже установленным.

...

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

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

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

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

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

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

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

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

Image Removed

Настройки

...

Контекст открытого сеанса работы с браузером.

...

Robin.Selenium

ACTION_CONTEXT

...

Да

...

Переменная, содержащая размер элемента.

...

Robin.RectangleLocation

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

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

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

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

Image Removed

Настройки

...

Контекст открытого сеанса работы с браузером.

...

Robin.Selenium

ACTION_CONTEXT

...

Да

...

Проверить видимость.

...

Проверить доступность.

...

Логическая переменная - результат проверки.

...

Robin.Boolean

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

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

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

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

Image Removed

Настройки

...

Контекст открытого сеанса работы с браузером.

...

Robin.Selenium

ACTION_CONTEXT

...

Да

...

Переменная, содержащая размер элемента.

...

Robin.String

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

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

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

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

Image Removed

Настройки

...

Контекст открытого сеанса работы с браузером.

...

ACTION_CONTEXT

...

Да

...

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

...

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

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

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

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

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

Image Removed

Настройки

...

Контекст открытого сеанса работы с браузером.

...

ACTION_CONTEXT

...

Да

...

Элемент для взаимодействия.

...

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

В выпадающем списке доступны значения:

• ЛКМ - Force click.
• ПКМ - Force right click.
• Двойной ЛКМ - Force double click.
• Средний - Middle

По умолчанию значение равно "ЛКМ".

...

Список горячих клавиш, которые будут комбинированы с кликом.

Для Selenium доступны три: Ctrl, Alt, Shift

...

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

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

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

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

Image Removed

Настройки

...

Контекст открытого сеанса работы с браузером.

...

ACTION_CONTEXT

...

Да

...

Элемент для взаимодействия.

...

Пауза между нажатием клавиш.

По умолчанию 0.

...

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

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

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

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

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

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

Image Removed

Настройки

...

Контекст открытого сеанса работы с браузером.

...

Robin.Selenium

ACTION_CONTEXT

...

Да

...

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

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

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

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

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

Image Removed

Настройки

...

Контекст открытого сеанса работы с браузером.

...

Robin.Selenium

ACTION_CONTEXT

...

Да

...

Количество пикселей, на которое нужно прокрутить вправо в горизонтальном направлении.

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

Отрицательное значение задает обратное направление прокрутки.

...

Количество пикселей, на которое нужно прокрутить вниз в вертикальном направлении.

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

Отрицательное значение задает обратное направление прокрутки.

...

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

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

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

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

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

Image Removed

Настройки

...

Контекст открытого сеанса работы с браузером.

...

ACTION_CONTEXT

...

Да

...

Элемент для взаимодействия.

...

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

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

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

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

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

Image Removed

Настройки

...

Контекст открытого сеанса работы с браузером.

...

Robin.Selenium

ACTION_CONTEXT

...

Да

...

Строковая переменная, содержащая название текст активного окна диалога.

...

Robin.String

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

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

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

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

Image Removed

Настройки

...

Контекст открытого сеанса работы с браузером.

...

Robin.Selenium

ACTION_CONTEXT

...

Да

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

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

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

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

Image Removed

Настройки

...

Контекст открытого сеанса работы с браузером.

...

Robin.Selenium

ACTION_CONTEXT

...

Да

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

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

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

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

Image Removed

Настройки

...

Контекст открытого сеанса работы с браузером.

...

Robin.Selenium

ACTION_CONTEXT

...

Да

...

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

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

Ожидания:

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

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

Image Removed

Настройки

...

Контекст открытого сеанса работы с браузером.

...

Robin.Selenium

ACTION_CONTEXT

...

Да

...

Имя атрибута, значение которого нужно ожидать.

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

Выпадающий список:

• Тип - tagName
• Значение - value
• Содержимое - innerHTML
• Текстовое содержимое - innerText
• Текстовый контент - textContent
• Отмеченное состояние - checked
• Выбранное состояние - selected
• другое

...

Значение атрибута, которое нужно ожидать.

Если поле не заполнено, будет установлено пустое значение или false для логических.

...

Robin.Object

...

Время ожидания выполнения условия.

...

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

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

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

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

Image Removed

Настройки

...

Контекст открытого сеанса работы с браузером.

...

Robin.Selenium

ACTION_CONTEXT

...

Да

...

Значение свойства стиля, которое нужно ждать.

...

Robin.Object

...

Время ожидания выполнения условия.

...

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

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

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

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

Image Removed

Настройки

...

Контекст открытого сеанса работы с браузером.

...

Robin.Selenium

ACTION_CONTEXT

...

Да

...

Использовать все текстовое содержимое

...

Ожидать во всем текстовом содержимом.

По умолчанию только в видимом тексте.

...

Вариант совпадения искомого текста с текстом элемента.

Выпадающий список:

• Строгое - заголовок равен параметру "Текст"
• Не строгое - заголовок содержит параметр "Текст"
• Регулярное выражение - Заголовок удовлетворяет регулярному выражению в параметре "Текст"

...

Время ожидания выполнения условия.

...

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

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

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

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

Image Removed

Настройки

...

Контекст открытого сеанса работы с браузером.

...

Robin.Selenium

ACTION_CONTEXT

...

Да

...

Вариант совпадения искомого текста с текстом элемента.

Выпадающий список:

• Строгое - заголовок равен параметру "Текст"
• Не строгое - заголовок содержит параметр "Текст"
• Регулярное выражение - Заголовок удовлетворяет регулярному выражению в параметре "Текст"

...

Время ожидания выполнения условия

...

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

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

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

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

Image Removed

Настройки

...

Контекст открытого сеанса работы с браузером.

...

Robin.Selenium

ACTION_CONTEXT

...

Да

...

Ожидаемое состояние свойства видимости.

Выпадающий список:

• Не проверять
• Видимый
• Невидимый

По умолчанию не проверять.

...

Ожидаемое состояние свойства доступности.

Выпадающий список:

• Не проверять
• Доступный
• Недоступный

По умолчанию не проверять.

...

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

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

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

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

Image Removed

Настройки

...

Контекст открытого сеанса работы с браузером.

...

Robin.Selenium

ACTION_CONTEXT

...

Да

...

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

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

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

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

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

Настройки

...

Контекст действия для работы с браузером

...

Идентификатор сеанса браузера

ACTION_CONTEXT

...

Да

...

File name

...

Folder path

...

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

Отсутствуют