Переключиться на фрейм / 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 и переключиться на него для дальнейшей работы с ним. 

Решение: воспользоваться действиями "Открыть браузер", "Переключиться на фрейм". 

Реализация:

  1. Собрать робота, состоящего из действий:

  2. Настроить параметры для действия "Открыть браузер". 

  3. Настроить параметр для действия "Переключиться на фрейм". 

  4. Нажать на кнопку "Старт" в верхней панели. 

Результат:

Программный робот отработал успешно.