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

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

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

Настройки

...

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

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

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

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

...

Chrome

...

Нет

...

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

...

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

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

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

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

Robin.String

...

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

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

...

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

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

...

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

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

...

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

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

...

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

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

...

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

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

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

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

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

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

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

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

Действие имеет в составе webpack с архивом драйверов для различных браузеров и их версий ( на текущий момент только chromedriver с 83 по 88-ю версии). 

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

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

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

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

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

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

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

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

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

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

Настройки

...

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

...

ACTION_CONTEXT

...

Да

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

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

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

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

Настройки

...

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

...

ACTION_CONTEXT

...

Да

...

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

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

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

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

Настройки

...

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

...

ACTION_CONTEXT

...

Да

...

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

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

...

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

...

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

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

Обновить / Refresh

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

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

Настройки

...

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

...

ACTION_CONTEXT

...

Да

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

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

Вперед / Forward

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

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

Настройки

...

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

...

ACTION_CONTEXT

...

Да

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

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

Назад / Back

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

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

Настройки

...

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

...

ACTION_CONTEXT

...

Да

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

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

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

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

Настройки

...

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

...

ACTION_CONTEXT

...

Да

...

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

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

...

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

...

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

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

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

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

...

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

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

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

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

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

Настройки

...

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

...

ACTION_CONTEXT

...

Да

...

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

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

...

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

...

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

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

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

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

...

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

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

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

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

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

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

Настройки

...

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

...

ACTION_CONTEXT

...

Да

...

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

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

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

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

...

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

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

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

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

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

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

Настройки

...

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

...

Robin.Selenium

ACTION_CONTEXT

...

Да

...

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

...

Robin.Object

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

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

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

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

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

Настройки

...

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

...

ACTION_CONTEXT

...

Да

...

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

...

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

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

...

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

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

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

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

...

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

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

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

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

Настройки

...

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

...

ACTION_CONTEXT

...

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

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

...

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

...

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

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

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

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

Настройки

...

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

...

Robin.Selenium

ACTION_CONTEXT

...

Да

...

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

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

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

...

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

...

Robin.Object

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

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

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

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

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

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

Настройки

...

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

...

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 (GetElementCssValue)

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

Настройки

...

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

...

Robin.Selenium

ACTION_CONTEXT

...

Да

...

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

...

Robin.Object

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

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

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

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

Настройки

...

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

...

Robin.Selenium

ACTION_CONTEXT

...

Да

...

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

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

...

Robin.Object

...

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

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

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

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

Настройки

...

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

...

ACTION_CONTEXT

...

Да

...

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

...

true

...

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

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

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

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

...

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

...

Robin.Collection

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

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

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

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

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

Настройки

...

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

...

ACTION_CONTEXT

...

Да

...

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

...

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

...

true

...

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

...

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

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

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

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

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

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

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

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

Настройки

...

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

...

Robin.Selenium

ACTION_CONTEXT

...

Да

...

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

...

Robin.RectangleLocation

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

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

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

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

Настройки

...

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

...

Robin.Selenium

ACTION_CONTEXT

...

Да

...

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

...

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

...

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

...

Robin.Boolean

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

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

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

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

Настройки

...

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

...

Robin.Selenium

ACTION_CONTEXT

...

Да

...

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

...

Robin.String

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

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

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

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

Настройки

...

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

...

ACTION_CONTEXT

...

Да

...

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

...

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

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

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

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

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

Настройки

...

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

...

ACTION_CONTEXT

...

Да

...

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

...

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

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

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

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

...

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

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

...

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

Указывает смещение от центра выбранного элемента.

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

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

Настройки

...

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

...

ACTION_CONTEXT

...

Да

...

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

...

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

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

...

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

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

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

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

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

Настройки

...

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

...

Robin.Selenium

ACTION_CONTEXT

...

Да

...

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

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

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

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

Настройки

...

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

...

Robin.Selenium

ACTION_CONTEXT

...

Да

...

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

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

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

...

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

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

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

...

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

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

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

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

Настройки

...

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

...

ACTION_CONTEXT

...

Да

...

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

...

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

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

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

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

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

Настройки

...

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

...

Robin.Selenium

ACTION_CONTEXT

...

Да

...

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

...

Robin.String

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

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

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

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

Настройки

...

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

...

Robin.Selenium

ACTION_CONTEXT

...

Да

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

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

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

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

Настройки

...

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

...

Robin.Selenium

ACTION_CONTEXT

...

Да

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

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

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

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

Настройки

...

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

...

Robin.Selenium

ACTION_CONTEXT

...

Да

...

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

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

Ожидания:

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

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

Настройки

...

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

...

Robin.Selenium

ACTION_CONTEXT

...

Да

...

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

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

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

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

...

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

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

...

Robin.Object

...

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

...

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

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

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

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

Настройки

...

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

...

Robin.Selenium

ACTION_CONTEXT

...

Да

...

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

...

Robin.Object

...

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

...

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

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

Ждать текста элемента  / Waiting for element text (WaitTextInElement)

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

Настройки

...

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

...

Robin.Selenium

ACTION_CONTEXT

...

Да

...

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

...

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

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

...

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

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

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

...

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

...

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

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

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

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

Настройки

...

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

...

Robin.Selenium

ACTION_CONTEXT

...

Да

...

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

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

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

...

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

...

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

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

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

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

Настройки

...

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

...

Robin.Selenium

ACTION_CONTEXT

...

Да

...

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

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

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

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

...

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

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

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

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

...

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

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

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

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

Настройки

...

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

...

Robin.Selenium

ACTION_CONTEXT

...

Да

...

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

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