Режим offline¶

Added in version 1.1.2: Добавлена поддержка режима offline.

Режим применяется для запуска программ и тестов с gs-automation без доступа к сети Интернет (закрытый контур).
Режим включается установкой значения true в параметре selenium.offline (Включение режима offline).
В режиме offline библиотека использует только установленные в системе веб-браузеры (Выбор используемого веб-браузера).
В режиме offline библиотека использует встроенные версии веб-драйверов (Встроенные веб-драйверы).
Встроенные веб-драйверы поставляются в компоненте gs-automation-webdrivers-x.x.x.jar (Встроенные веб-драйверы).
Предоставляется возможность использовать сторонний веб-драйвер, указав путь до его исполняемого файла в параметре selenium.driver (Назначение стороннего веб-драйвера).

Включение режима offline¶

Параметр включения:

selenium.offline = true (см. Параметры окружения, Параметры окружения выполнения).

При установке значения true gs-automation подберет для выбранного веб-браузера подходящий встроенный веб-драйвер.

Встроенные веб-драйверы¶

Встроенные веб-драйверы поставляются в компоненте gs-automation-webdrivers-x.x.x.jar.
При включении режима offline веб-драйверы распаковываются в .cache/gs-automation-selenium в домашней папке текущего пользователя.
Если папка не может быть создана или нет прав на запись, используется системная временная папка.
Если временная папка также недоступна, библиотека завершает работу с ошибкой.

Note

В режиме offline gs-automation использует только установленные в системе веб-браузеры.

Caution

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

При невозможности использовать установленную в системе версию веб-браузера, библиотека gs-automation остановит свою работу с ошибкой.

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

Выбор используемого веб-браузера¶

Параметр выбора браузера:

browser.name (см. Параметры окружения, Параметры окружения выполнения).
Допустимые значения: Chrome, Edge, Firefox, Yandex.
Значение по умолчанию: Chrome.

Note

При использовании браузера Yandex режим offline включается автоматически.

Поддерживаемые веб-браузеры и платформы¶

Веб-браузеры и платформы¶
Веб-браузер	Платформы
Chrome	windows x64, linux x64
Edge	windows x64, linux x64
Firefox	windows x64
Yandex	windows x64, linux x64

Назначение стороннего веб-драйвера¶

Предоставляется возможность использовать сторонний веб-драйвер.

Параметры:

selenium.driver задает путь до исполняемого файла веб-драйвера.
selenium.offline должно быть true.

Ограничения:

При назначении параметра selenium.driver библиотека не проверяет совместимость указанного веб-драйвера с ОС, архитектурой CPU и установленным браузером.
Любые ошибки выполнения стороннего веб-драйвера приводят к остановке работы с ошибкой.

Ошибки, причины и рекомендации по исправлению¶

Ошибки режима offline¶
Ситуация	Причина	Рекомендация
Не удалось создать `.cache/gs-automation-selenium` и/или временную папку	Нет прав на запись	Обеспечить доступ на запись в домашнюю или временную папку
Совместимый встроенный веб-драйвер не найден	Для выбранного веб-браузера нет подходящего встроенного веб-драйвера	Установить и указать сторонний веб-драйвер через `selenium.driver`
Веб-браузер не обнаружен	Выбранный веб-браузер не установлен в системе	Установить браузер или использовать сторонний веб-драйвер
Версия установленного веб-браузера несовместима со встроенным веб-драйвером	Несоответствие версий браузера и драйвера	Установить совместимый браузер или использовать сторонний web-драйвер
Ошибка выполнения стороннего веб-драйвера	Несовместимость, повреждение или неверный путь к файлу веб-драйвера	Проверить корректность файла и совместимость веб-драйвера