.. _gsauto_ug_envprops:

Параметры окружения выполнения
==============================

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

Изменение значений параметров не требует пересборки программы. Достаточно изменить 
значение в файле свойств или установить переменную окружения.

.. seealso::

   - Спецификация: :ref:`gsauto_envprops`
   - API: :java:type:`ru.bitec.gs.automation.parameters.GsAutoProps <ru.bitec.gs.automation.parameters.GsAutoProps>`

Пример
------

Рассмотрим параметр управления шириной окна браузера.

Базовое название параметра: ``browser.window.width``

Название параметра для разных источников значений:

   - Файл свойств: ``browser.window.width``
   - Переменная окружения операционной системы: ``GSAUTO_BROWSER_WINDOW_WIDTH``
   - Аргумент командной строки: ``gsauto.browser.window.width``

Для установки ширины окна равной ``1920`` пикселям:

1. В файле свойств:

   .. code-block:: properties

      browser.window.width=1920

2. В Windows-терминале:

   .. code-block:: bash

      set GSAUTO_BROWSER_WINDOW_WIDTH=1920

3. В Unix-подобных системах:

   .. code-block:: bash

      export GSAUTO_BROWSER_WINDOW_WIDTH=1920

4. При запуске программы или тестов:

   .. code-block:: bash

      gradle test -Dgsauto.browser.window.width=1920