Группа: Браузеры

Подгруппа: Окна, вкладки, фреймы

Последняя версия: 12 (Java)

Описание

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

Применение

  1. Открыть браузер действием «Открыть браузер» или подключиться к открытому бразуру действием «Подключиться к открытому браузеру».
  2. Выполнить скрипт в браузере действием «Выполнить скрипт».
  3. Обработать полученный результат выполнения скрипта.


Параметры и их настройки

Свойство

Описание

Тип

Пример
заполнения

Обязательность
заполнения поля

Параметры

Контекст

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

Экземпляр Selenium

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

Да

Скрипт

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

Строка

return document.title;

Да

Параметры скрипта

Параметры, передаваемые в скрипт. В скрипте места подстановки параметров должны быть отмечены как arguments[0]. Можно передавать только значения типов: Коллекция, Строка, Число, Логический.

Объект: Коллекция, Логический, Строка, Число

[2, 3]

Нет

Тайм-аут, мс

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

Число

30000

Нет

Результаты

Результат

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

Объект

Заголовок текущей страницы


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

В параметре «Тайм-аут, мс» допустимы только целые неотрицательные числа: 0, 1, 2 и так далее.

Если параметр «Тайм-аут, мс» не заполнен, действие ожидает завершения скрипта без заданного пользователем ограничения времени.

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

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

Параметр «Параметры скрипта» передаёт в скрипт одно значение типа Коллекция, Строка, Число или Логический. Для обращения к переданному значению используйте arguments[0]. Если передана коллекция, обращайтесь к её элементам через arguments[0][0], arguments[0][1] и так далее. Если параметр не заполнен, скрипт выполняется без переданных значений.

Исключения

№

Событие

Описание ошибки в логе

1

Истекло время ожидания выполнения скрипта.

Истекло время ожидания исполнения скрипта.

2

В параметре «Тайм-аут, мс» указано отрицательное, дробное или иное недопустимое значение.

Некорректное значение параметра «Тайм-аут, мс»

Сценарии использования

<описание сложного или неочевидного сценария настройки параметров действия>

Изменения в версии

Добавлен необязательный параметр «Тайм-аут, мс», который позволяет задать время ожидания выполнения скрипта в миллисекундах. Ранее действие использовало внутренний тайм-аут 30 секунд.

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

При превышении заданного тайм-аута действие сообщает об истечении времени ожидания. В текущей версии сам скрипт не прерывается, поэтому ошибка отображается после завершения его выполнения.


Версии

  • Нет меток