История страницы
...
Технически, действие перемещает фокус управления по структуре фреймов. Для этого необходимо указать целевой фрейм, в который нужно перейти, и область поиска этого фрейма.
Иконка
Параметры действия
Поле "Контекст" - необходимо указать контекст открытого браузера, в котором нужно искать фрейм. Страница браузера, где расположен нужный фрейм, должна быть открыта (действие "Открыть браузер").
Заполните (необязательные) параметры, можно выбрать один:
Поле "Элемент" - необходимо указать веб-элемент, указывающий на фрейм. Такой элемент может быть создан вручную или с помощью WebSpy. Подробнее в разделе Create Web-elements
Поле "Имя" - можно указать имя фрейма. Например: Для поиска такого имени фрейма воспользуйтесь консолью разработчика (клавиша F12 в chrome). Если у элемента отсутствует имя, то необходимо захватить его отдельно и указать в поле "Элемент", как указано в предыдущем параметре.
Поле "Индекс" - можно указать порядковый номер фрейма в структуре страницы. Фреймы нумеруются по порядку от верха страницы браузера, нумерация фреймов начинается с нуля. Количество фреймов и их расположение в разметке страницы можно посмотреть также в консоли разработчика.
Если заполнены все три поля, то робот по порядку обходит параметры и пытается по ним искать фрейм.
Если одна из проверок наличия фрейма, по порядку, вернет ошибку, то действие завершит работу с ошибкой. Соответственно, если имя существует, а веб-элемент нет, но все равно указан, то действие отобразит ошибку.
Поле "Область поиска фрейма" - указывает направление поиска нужного фрейма для перехода. Относительно текущего положения, можно искать вниз структуры фрейма (по вложенным дочерним фреймам), вверх структуры фрейма (в родительском фрейме), либо выйти на самый верх структуры страницы Для этого выберите одну из возможных опций:
- Текущий фрейм - действие будет искать фрейм, указанный в полях Элемент/Имя/Индекс в текущем местоположении (фрейме).
- Родительский фрейм - действие будет искать фрейм, указанный в полях Элемент/Имя/Индекс, в родительском фрейме, расположенном на уровень выше относительно текущего местоположения (фрейма). Также используйте эту опцию, когда текущий фокус находится в самом верху структуры страницы, например, когда вы только что открыли данную страницу.
- Вся страница - действие выполнит переключение фокуса из фрейма (из любого уровня вложенности) обратно на страницу. При использовании этой опции поля Элемент/Имя/Индекс не заполняются.
Если структура страницы имеет несколько уровней вложенности фреймов, то для переключения к фрейму, находящемуся на n-уровне вложенности, необходимо выполнить n действий переключения на фрейм, последовательно.
Настройки
Свойство | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
Параметры | ||||
Контекст | Контекст действия для работы с браузером. | Robin.Selenium | Контекст браузера | Да |
Элемент | Фрейм, как элемент для взаимодействия | Robin.WebElement | /html/body/div[5]/div[4]/div/div | Нет |
Имя | Имя фрейма | Robin.String | iframeResult | Нет |
Индекс | Индекс фрейма. Нумерация начинается с 0. | Robin.Numeric | 1 | Нет |
Область поиска фрейма | Область поиска фрейма. Доступно 3 варианта: текущий фрейм - поиск в рамках текущего фрейма; родительский фрейм - поиск в рамках родительского фрейма; вся страница - поиск в рамках всей страницы. | Robin.String | Родительский фрейм | Нет |
...
Пример использования действия с использованием параметров "Индекс" и опций параметра "Область поиска":
Задача 1
Реализовать действия с использованием параметров "Индекс" и опций параметра "Область поиска".
- Опция Родительский фрейм - будем искать во фрейме находящемся на уровень выше относительно текущего фокуса (фрейма), либо когда фокус находится на основной странице. На сайте 3 фрейма (можно посмотреть с помощью консоли разработчика). Для переключения на третий фрейм заполним параметры:
...
- в поле "Контекст" укажем контекст открытого браузера,
- в поле "Индекс" укажем значение 1 (нумерация фреймов начинается с 0),
- в поле "Область поиска фрейма" укажем значение "Текущий фрейм" (ищем дочерний фрейм в текущем фрейм).
Далее, с помощью действие "Получить текст" получим текст из фрейма (см. приложенную к описанию схему робота).
...
Выполним действие "Получить текст" из основной страницы (см. приложенную к описанию схему робота).
Пример использования действия с использованием параметров "Имя", "Элемент" и опций "Область поиска"
...
Задача 2
Зайти на сайт с фреймом https://www.w3schools.com/css/tryit.asp?filename=trycss_default, переключиться на него для дальнейшей работы с ним и получить текст из фрейма "My First CSS Example".
Реализовать действие с использованием параметров "Имя", "Элемент" и опций "Область поиска".
Решение
Воспользоваться действиями "Открыть браузер", "Переключиться на фрейм", "Получить текст".
...