GsAutoProps¶

public enum GsAutoProps¶

Added in version 1.1.1.

Added in version 1.1.2: Добавлены параметры SeleniumOffline и SeleniumDriver. Добавлено значение Yandex для параметра Browser.

Added in version 1.2.0: Добавлен параметр GridResizeHorizontalSafeZonePadding

Настройки библиотеки gs-automation и окружения ее выполнения.

При получении значения параметра, используются несколько источников значений. Источники перебираются в определенном порядке, пока не будет найдено значение. Найденное значение вернется получателю. Если значение не будет найдено ни в одном источнике значений, то вернется значение по умолчанию.

Если значением по умолчанию является null, то такой параметр является обязательным (за исключением параметра SeleniumDriver) и должен быть задан явно в каком-либо источнике значений, подходящем под условия выполнения тестов. Если значение обязательного параметра не задано соответствующий образом, библиотека gs-automation будет выбрасывать соответствующие исключения в соответствующие моменты времени использования.

Каждое значение ищется по уникальному имени параметра. Имя параметра имеет “базовое название”, которое, в зависимости от источника значений, может быть преобразовано в аналогичное, с учетом особенностей источника значений.

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

Порядок перебора источников значений:

Параметры командной строки, определенные через -D
Переменные окружения
Файл gs-automation.properties в текущей директории
Файл gs-automation.properties в ресурсах библиотеки gs-automation

Правила преобразования базового названия параметра для каждого из источников значений:

Параметры командной строки, определенные через -D: “gsauto.” + <базовое название>
Переменные окружения: “GSAUTO_” + <базовое название>.toUpperCase().replace(“.”, “_”)
Файл gs-automation.properties в текущей директории: <базовое название>
Файл gs-automation.properties в ресурсах библиотеки gs-automation: <базовое название>

Enum Constants¶

AdminPassword¶

public static final GsAutoProps AdminPassword¶

Пароль административного пользователя, для доступа к служебным сервисам сервера приложений. Используется для принудительного завершения рабочего сеанса/сеансов при возникновении нештатной ситуации в тесте.

Базовое название параметра: host.admin.password

Тип значения: String

Значение по умолчанию: null

AdminUser¶

public static final GsAutoProps AdminUser¶

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

Базовое название параметра: host.admin.user

Тип значения: String

Значение по умолчанию: null

ApplicationName¶

public static final GsAutoProps ApplicationName¶

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

Базовое название параметра: host.application.name

Тип значения: String

Значение по умолчанию: null

Browser¶

public static final GsAutoProps Browser¶

Используемый браузер.

Базовое название параметра: browser.name

Тип значения: WebDriverBuilder.SupportedBrowser

Допустимые значения: Chrome, Firefox, Edge, Yandex

При использовании Yandex параметр SeleniumOffline имеет константное значение true.

Значение по умолчанию: WebDriverBuilder.SupportedBrowser.Chrome

BrowserSandbox¶

public static final GsAutoProps BrowserSandbox¶

Added in version 1.2.1.

Включить sandbox-изоляцию процессов браузера. По умолчанию - включен.

В Linux, из-за ограничений прав доступа, скорее всего потребуется его отключение.

Базовое название параметра: browser.sandbox

Тип значения: Boolean

Значение по умолчанию: true

BrowserWindowHeight¶

public static final GsAutoProps BrowserWindowHeight¶

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

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

Тип значения: Integer

Значение по умолчанию: 1024

BrowserWindowWidth¶

public static final GsAutoProps BrowserWindowWidth¶

Ширина окна браузера в пикселях.

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

Тип значения: Integer

Значение по умолчанию: 1280

Colorizable¶

public static final GsAutoProps Colorizable¶

Включить цвето-анимационное диагностическое поведение.

Базовое название параметра: dom.colorizable

Тип значения: Boolean

Значение по умолчанию: true

DurationAfterAllTimeout¶

public static final GsAutoProps DurationAfterAllTimeout¶

Длительность профилактических пауз, выполняющихся после каждого класса тестов.

Базовое название параметра: duration.afterall.timeout

Тип значения: Duration

Значение по умолчанию: 50 миллисекунд

DurationDomStability¶

public static final GsAutoProps DurationDomStability¶

Длительность ожидания стабилизации dom-модели.

Базовое название параметра: duration.dom.stability

Тип значения: Duration

Значение по умолчанию: 500 миллисекунд

DurationParser.parse(java.lang.String)

DurationWaitApplication¶

public static final GsAutoProps DurationWaitApplication¶

Длительность ожидания получения представления приложения с сервера приложений.

Базовое название параметра: duration.wait.application

Тип значения: Duration

Значение по умолчанию: 60 секунд

DurationWaitElement¶

public static final GsAutoProps DurationWaitElement¶

Длительность ожидания появления dom-элемента на dom-модели.

Базовое название параметра: duration.wait.element

Тип значения: Duration

Значение по умолчанию: 5 секунд

DurationWaitElementClickable¶

public static final GsAutoProps DurationWaitElementClickable¶

Длительность ожидания того, что dom-элемент готов реагировать на клики мышкой.

Базовое название параметра: duration.wait.elementclickable

Тип значения: Duration

Значение по умолчанию: 2 секунд

DurationWaitFormClose¶

public static final GsAutoProps DurationWaitFormClose¶

Длительность ожидания закрытия (после отправки запроса на закрытие) формы.

Базовое название параметра: duration.wait.formclose

Тип значения: Duration

Значение по умолчанию: 10 секунд

DurationWaitFormOpen¶

public static final GsAutoProps DurationWaitFormOpen¶

Длительность ожидания получения представления открывающейся (после отправки запроса на открытие) формы с сервера приложений.

Базовое название параметра: duration.wait.formopen

Тип значения: Duration

Значение по умолчанию: 15 секунд

DurationWaitMainForm¶

public static final GsAutoProps DurationWaitMainForm¶

Длительность ожидания получения представления главной формы с сервера приложений.

Базовое название параметра: duration.wait.mainform

Тип значения: Duration

Значение по умолчанию: 15 секунд

GridResizeHorizontalSafeZonePadding¶

public static final GsAutoProps GridResizeHorizontalSafeZonePadding¶

Added in version 1.2.0.

Отступ от левого и правого края табличного представления, внутри которого запрещено изменять ширину колонок. Значение задаётся в пикселях. Например, если параметр равен 5, то изменение ширины колонок будет доступно только начиная с позиции 5px от левого края и до (<gridWidth> - 5)px от правого края.

Используется для предотвращения конфликтов при изменении размера ширины колонок вблизи краёв табличного представления.

Базовое название параметра: grid.resize.horizontal.safezonepadding

Тип значения: Integer

Значение по умолчанию: 5 (пикселей)

Headless¶

public static final GsAutoProps Headless¶

Не показывать окно браузера (headless mode).

Базовое название параметра: browser.headless

Тип значения: Boolean

Значение по умолчанию: false

Locale¶

public static final GsAutoProps Locale¶

Язык интерфейса браузера.

Базовое название параметра: browser.locale

Тип значения: String в виде, понятном конкретному браузеру

Значение по умолчанию: “en”

Password¶

public static final GsAutoProps Password¶

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

Базовое название параметра: host.password

Тип значения: String

Значение по умолчанию: null

SeleniumDriver¶

public static final GsAutoProps SeleniumDriver¶

Added in version 1.1.2.

Используемый web-драйвер.

Путь до используемого web-драйвера. Параметр следует назначать в тех случаях, когда требуется работа в режиме SeleniumOffline, но web-драйвера, содержащиеся в gs-automation-webdrivers-x.x.x.jar, не совместимы с установленным браузером и приходится использовать версии, отдельно скачанные с сайта производителя.

При значении по умолчанию (null), gs-automation использует web-драйвер согласно указанному значению параметра SeleniumOffline: если значение false — из сети скачивается и используется подходящий web-драйвер, если значение true — используется web-драйвер содержащиеся в gs-automation-webdrivers-x.x.x.jar.

При указании этого значения не производится проверка совместимости web-драйвера и браузера Browser. Так же не производится проверка значения параметра SeleniumOffline. Вся ответственность за корректность значений этих параметров лежит на эксплуатанте.

Базовое название параметра: selenium.driver

Тип значения: Path

Значение по умолчанию: null

SeleniumOffline¶

public static final GsAutoProps SeleniumOffline¶

Added in version 1.1.2.

Выполнение в offline-режиме.

Если значение true, то Selenium будет использовать web-драйверы, содержащиеся в gs-automation-webdrivers-x.x.x.jar и не будет пытаться скачать их и соответствующие браузеры из сети.

Если параметр Browser имеет значение Yandex, то значение параметра SeleniumOffline всегда равно true и не может быть переопределено.

Базовое название параметра: selenium.offline

Тип значения: Boolean

Значение по умолчанию: false

ServerAddress¶

public static final GsAutoProps ServerAddress¶

URL сервера приложений.

Базовое название параметра: host.server.address

Тип значения: String URL в формате <protocol>://<hostname>[:<port:>]

Значение по умолчанию: null

Solution¶

public static final GsAutoProps Solution¶

Имя решения, в котором запустится приложение.

Базовое название параметра: host.solution

Тип значения: String

Значение по умолчанию: null

StartupFormName¶

public static final GsAutoProps StartupFormName¶

Имя формы, открывающейся на старте приложения.

Базовое название параметра: host.startup.form.name

Тип значения: String

Значение по умолчанию: null

User¶

public static final GsAutoProps User¶

Имя пользователя, под которым выполняются тесты.

Базовое название параметра: host.user

Тип значения: String

Значение по умолчанию: null

Methods¶

getDefaultValue¶

Object getDefaultValue()¶

getPropName¶

String getPropName()¶

getValueType¶

Class<?> getValueType()¶

value¶

public <T> T value()¶

Получить значение параметра.

Parameters:

<T> – тип значения параметра

Returns:

значение параметра

valueOf¶

public static GsAutoProps valueOf(String name)¶

values¶

public static GsAutoProps[] values()¶