Переключиться на фрейм / Switch to frame
Группа действий: Браузеры
Действие переключается на заданный фрейм.
Настройки
Свойство | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
Параметры | ||||
Контекст | Экземпляр браузера. | Robin.Selenium | Контекст браузера | Да |
XPath | Обязательный параметр. XPath запрос для поиска вэб-элемента. Используйте префикс „//“ для поиска элемента во всем документе и префикс „.//“ для поиска только среди дочерних элементов. | Robin.String | Да | |
Имя фрейма | Необязательный параметр. Имя фрейма. Значение по умолчанию: пустая строка. Приоритет (по убыванию): XPath, Имя фрейма, Индекс фрейма. Для переключения на родительский фрейм: XPath = пустая строка & Имя фрейма = пустая строка и Индекс фрейма = 0. Для переключения на основной документ: XPath = пустая строка & Имя фрейма = пустая строка и Индекс фрейма = -1. | Robin.String | Нет | |
Индекс фрейма | Необязательный параметр. Индекс фрейма. Отсчет индексов начинается с 1. Значение по умолчанию: 0. Приоритет (по убыванию): XPath, Имя фрейма, Индекс фрейма. Для переключения на родительский фрейм: XPath = пустая строка & Имя фрейма = пустая строка и Индекс фрейма = 0. Для переключения на основной документ: XPath = пустая строка & Имя фрейма = пустая строка и Индекс фрейма = -1. | Robin.Numeric | Нет |
Особые условия использования
При работе с элементами страницы элементы фрейма недоступны. Для того, чтобы обратиться к элементам фрейма, на него необходимо переключиться.
При работе с элементами фрейма элементы страницы недоступны. Для того, чтобы продолжить работу с элементами страницы, необходимо переключиться с фрейма обратно на страницу.
Повторно перейти на текущую вкладку возможно также с помощью действия "Переключиться на вкладку".
Пример использования
Задача: зайти на сайт с фреймом https://codepen.io/GBora/pen/VLYyzY и переключиться на него для дальнейшей работы с ним.
Решение: воспользоваться действиями "Открыть браузер", "Переключиться на фрейм".
Реализация:
- Собрать робота, состоящего из действий:
- Настроить параметры для действия "Открыть браузер".
- Настроить параметр для действия "Переключиться на фрейм".
- Нажать на кнопку "Старт" в верхней панели.
Результат:
Программный робот отработал успешно.