.. java:import:: java.io IOException

.. java:import:: java.nio.file Path

.. java:import:: org.openqa.selenium.remote AbstractDriverOptions

.. java:import:: org.openqa.selenium.remote.service DriverService

OfflineDrivers
==============

.. java:package:: ru.bitec.gs.automation.webdrivers
   :noindex:

.. java:type:: public sealed enum OfflineDrivers

   .. versionadded:: 1.1.2

   Перечисление поддерживаемых offline web-драйверов.

   Каждый элемент перечисления определяет свою реализацию метода :java:ref:`applyOptions(Path, AbstractDriverOptions, Path) <ru.bitec.gs.automation.webdrivers.OfflineDrivers.applyOptions(Path, AbstractDriverOptions, Path)>`.
   Реализации метода, в целом, идентичны друг-другу. Сделано с запасом на перспективу: на случай если потом будут выявлены
   потребности в индивидуальном конфигурировании.

Enum Constants
--------------

Chrome
^^^^^^

.. java:field:: public static final OfflineDrivers Chrome
   :outertype: OfflineDrivers

Edge
^^^^

.. java:field:: public static final OfflineDrivers Edge
   :outertype: OfflineDrivers

Firefox
^^^^^^^

.. java:field:: public static final OfflineDrivers Firefox
   :outertype: OfflineDrivers

Yandex
^^^^^^

.. java:field:: public static final OfflineDrivers Yandex
   :outertype: OfflineDrivers

Methods
-------

applyOfflineOptions
^^^^^^^^^^^^^^^^^^^

.. java:method:: public DriverService applyOfflineOptions(AbstractDriverOptions targetOptions, Path driverPathConfigured) throws IOException
   :outertype: OfflineDrivers

   Применить настройки, связанные с offline-режимом работы.

   Метод распаковывает ресурсы с закэшированными web-драйверами в папку с кэшем web-драйверов и вызывает конкретную реализацию
   метода :java:ref:`applyOptions(Path, AbstractDriverOptions, Path) <ru.bitec.gs.automation.webdrivers.OfflineDrivers.applyOptions(Path, AbstractDriverOptions, Path)>`.

   :param targetOptions: опции web-драйвера, установленные ранее и не зависящие от режима использования web-драйвера
   :param driverPathConfigured: путь до драйвера в случае, если он явно указан в параметрах gs-automation. Иначе: null.
   :throws IOException: если не удалось создать временную папку для кэша web-драйверов
   :return: экземпляр сервиса web-драйвера для использования при инициализации web-драйвера.

applyOptions
^^^^^^^^^^^^

.. java:method:: protected abstract DriverService applyOptions(Path cachePath, AbstractDriverOptions targetOptions, Path driverPathConfigured)
   :outertype: OfflineDrivers

   Применить специфичные для конкретного web-драйвера настройки, связанные с offline-режимом работы.

   Метод определяется индивидуально для каждого поддерживаемого web-драйвера.

   :param cachePath: путь до папки с кэшем web-драйверов
   :param targetOptions: опции web-драйвера, установленные ранее и не зависящие от режима использования web-драйвера
   :param driverPathConfigured: путь до драйвера в случае, если он явно указан в параметрах gs-automation. Иначе: null.
   :return: экземпляр сервиса web-драйвера для использования при инициализации web-драйвера.

getDriverPath
^^^^^^^^^^^^^

.. java:method:: protected String getDriverPath()
   :outertype: OfflineDrivers

   Получить путь до web-драйвера в кэше.

   :return: путь до web-драйвера

valueOf
^^^^^^^

.. java:method:: public static OfflineDrivers valueOf(String name)
   :outertype: OfflineDrivers

values
^^^^^^

.. java:method:: public static OfflineDrivers[] values()
   :outertype: OfflineDrivers