Application

public class Application extends AbstractUiElement implements KeyboardInput

New in version 1.1.0: Методы и их сигнатуры приведены к соглашению по именам. Добавлены методы ожидания контекстного меню, получения панели MDI-вкладок, клика по body-элементу.

Приложение, корневой элемент пользовательского интерфейса.

Constructors

Application

public Application(BrowserContext browserContext, WebElement webElement)

Methods

bodyClick

public void bodyClick()

Метод выполняет клик мышкой в DOM-элемент body. Это действие позволяет “сбросить” фокусы, выделения и подобные состояния на интерфейсе.

forms

public AbstractForm[] forms()

Метод выполняет поиск всех форм открытых в приложении.

Returns

Массив форм

get

public static Application get(BrowserContext browserContext)

Метод возвращает html-элемент, соответствующий Application, в дереве html-элементов браузера.

Parameters

• browserContext – контекст браузера

Throws

• org.openqa.selenium.NoSuchElementException – если приложение не найдено

Returns

Приложение

getKeyboardInputWebElement

public Optional<WebElement> getKeyboardInputWebElement()

Перенаправляет клавиатурные последовательности в dom-элемент window.

Returns

Optional.empty()

getServerVersion

public String getServerVersion()

Возвращает версию сервера приложений в формате: “Major.Minor.Release[-[ms|rc]Number]”.

Значение хранится в атрибуте Attributes.DATA_SERVER_VERSION html-элемента.

Returns

версия

getSessionId

public String getSessionId()

Возвращает идентификатор пользовательской сессии.

Значение хранится в атрибуте Attributes.DATA_SESSION_ID html-элемента.

Returns

идентификатор сессии

lookupForm

public Form lookupForm(String name)

Метод возвращает модальную форму, в режиме выбора значения, с указанным именем.

Parameters

• name –

  Имя формы.

  Примеры допустимых значений

  • gtk-ru.company.module.Module_SelectionName#Representation

  • gtk-Module_SelectionName#Representation

  • ru.company.module.Module_SelectionName#Representation

  • Module_SelectionName#Representation

  Если значение не будет содержать имени отображения, будет использовано значение по умолчанию Defaults.REPRESENTATION.

Throws

• ElementNotFoundException – если форма не найдена

Returns

Форма

lookupForm

public Form lookupForm(String name, String representation)

Метод возвращает модальную форму, в режиме выбора значения, с указанным именем.

Parameters

• name –

  Имя главной выборки формы.

  Примеры допустимых значений

  • gtk-ru.company.module.Module_SelectionName

  • gtk-Module_SelectionName

  • ru.company.module.Module_SelectionName

  • Module_SelectionName

• representation – Отображение главной выборки формы.

Throws

• ElementNotFoundException – если форма не найдена

Returns

Форма

lookupForms

public Form[] lookupForms()

Метод выполняет поиск всех модальных форм, в режиме выбора значения, открытых в приложении.

Returns

Массив форм

mainForm

public MainForm mainForm()

Метод возвращает главную форму приложения MainForm.

Throws

• ElementNotFoundException – если форма не найдена

Returns

Главная форма

mdiForm

public Form mdiForm(String name)

Метод возвращает MDI-форму с указанным именем.

Parameters

• name –

  Имя формы.

  Примеры допустимых значений

  • gtk-ru.company.module.Module_SelectionName#Representation

  • gtk-Module_SelectionName#Representation

  • ru.company.module.Module_SelectionName#Representation

  • Module_SelectionName#Representation

  Если значение не будет содержать имени отображения, будет использовано значение по умолчанию Defaults.REPRESENTATION.

Throws

• ElementNotFoundException – если форма не найдена

Returns

Форма

mdiForm

public Form mdiForm(String name, String representation)

Метод возвращает MDI-форму с указанным именем.

Parameters

• name –

  Имя главной выборки формы.

  Примеры допустимых значений

  • gtk-ru.company.module.Module_SelectionName

  • gtk-Module_SelectionName

  • ru.company.module.Module_SelectionName

  • Module_SelectionName

• representation – Отображение главной выборки формы.

Throws

• ElementNotFoundException – если форма не найдена

Returns

Форма

mdiForms

public Form[] mdiForms()

Метод возвращает все MDI-формы, открытые в приложении.

Returns

Массив форм

mdipanel

public MdiPanel mdipanel()

Возвращает панель вкладок открытых MDI-форм приложения MdiPanel.

Throws

• ElementNotFoundException – если панель не найдена

Returns

Панель вкладок открытых MDI-форм приложения.

modalForm

public Form modalForm(String name)

Метод возвращает модальную форму с указанным именем.

Parameters

• name –

  Имя формы.

  Примеры допустимых значений

  • gtk-ru.company.module.Module_SelectionName#Representation

  • gtk-Module_SelectionName#Representation

  • ru.company.module.Module_SelectionName#Representation

  • Module_SelectionName#Representation

  Если значение не будет содержать имени отображения, будет использовано значение по умолчанию Defaults.REPRESENTATION.

Throws

• ElementNotFoundException – если форма не найдена

Returns

Форма

modalForm

public Form modalForm(String name, String representation)

Метод возвращает модальную форму с указанным именем.

Parameters

• name –

  Имя главной выборки формы.

  Примеры допустимых значений

  • gtk-ru.company.module.Module_SelectionName

  • gtk-Module_SelectionName

  • ru.company.module.Module_SelectionName

  • Module_SelectionName

• representation – Отображение главной выборки формы.

Throws

• ElementNotFoundException – если форма не найдена

Returns

Форма

modalForms

public Form[] modalForms()

Метод выполняет поиск всех модальных форм открытых в приложении.

Returns

Массив форм

wait

public static Application wait(BrowserContext browserContext)

Метод выполняет ожидание появления html-элемента, соответствующего Application, в дереве html-элементов браузера.

Parameters

• browserContext – контекст браузера

Throws

• org.openqa.selenium.TimeoutException – если не дождались

Returns

Приложение

wait

public static Application wait(BrowserContext browserContext, Duration duration)

Метод выполняет ожидание появления html-элемента, соответствующего Application, в дереве html-элементов браузера.

Parameters

• browserContext – контекст браузера

• duration – длительность ожидания

Throws

• org.openqa.selenium.TimeoutException – если не дождались

Returns

Приложение

waitContextMenu

public ContextMenu waitContextMenu()

Дождаться открытия контекстного меню ContextMenu.

Throws

• ElementNotFoundException – если контекстное меню не найдено

Returns

контекстное меню.

waitLookupForm

public Form waitLookupForm(String name)

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

Parameters

• name –

  Имя формы.

  Примеры допустимых значений

  • gtk-ru.company.module.Module_SelectionName#Representation

  • gtk-Module_SelectionName#Representation

  • ru.company.module.Module_SelectionName#Representation

  • Module_SelectionName#Representation

  Если значение не будет содержать имени отображения, будет использовано значение по умолчанию Defaults.REPRESENTATION.

Throws

• ElementNotFoundException – если не удалось дождаться lookup-форму

Returns

Форма

waitLookupForm

public Form waitLookupForm(String name, String representation)

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

Parameters

• name –

  Имя главной выборки формы.

  Примеры допустимых значений

  • gtk-ru.company.module.Module_SelectionName

  • gtk-Module_SelectionName

  • ru.company.module.Module_SelectionName

  • Module_SelectionName

• representation – Отображение главной выборки формы.

Throws

• ElementNotFoundException – если не удалось дождаться lookup-форму

Returns

Форма

waitLookupForm

public Form waitLookupForm(String name, String representation, Duration duration)

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

Parameters

• name –

  Имя главной выборки формы.

  Примеры допустимых значений

  • gtk-ru.company.module.Module_SelectionName

  • gtk-Module_SelectionName

  • ru.company.module.Module_SelectionName

  • Module_SelectionName

• representation – Отображение главной выборки формы.

• duration – Длительность ожидания.

Throws

• ElementNotFoundException – если не удалось дождаться lookup-форму

Returns

Форма

waitMainForm

public MainForm waitMainForm()

Метод выполняет ожидание открытия главной формы приложения MainForm (применяется при открытии приложения) и возвращает эту форму.

Throws

• ElementNotFoundException – если главная форма не открылась

Returns

Главная форма

waitMdiForm

public Form waitMdiForm(String name)

Метод выполняет ожидание открытия MDI-формы с указанным именем и возвращает эту форму.

Если форма уже открыта, или открыты несколько форм с одним именем, будет возвращена ссылка на первую найденную форму.

Parameters

• name –

  Имя формы.

  Примеры допустимых значений

  • gtk-ru.company.module.Module_SelectionName#Representation

  • gtk-Module_SelectionName#Representation

  • ru.company.module.Module_SelectionName#Representation

  • Module_SelectionName#Representation

  Если значение не будет содержать имени отображения, будет использовано значение по умолчанию Defaults.REPRESENTATION.

Throws

• ElementNotFoundException – если не удалось дождаться открытия Mdi-формы

Returns

Форма

waitMdiForm

public Form waitMdiForm(String name, String representation)

Метод выполняет ожидание открытия MDI-формы с указанным именем и возвращает эту форму.

Если форма уже открыта, или открыты несколько форм с одним именем, будет возвращена ссылка на первую найденную форму.

Parameters

• name –

  Имя главной выборки формы.

  Примеры допустимых значений

  • gtk-ru.company.module.Module_SelectionName

  • gtk-Module_SelectionName

  • ru.company.module.Module_SelectionName

  • Module_SelectionName

• representation – Отображение главной выборки формы.

Throws

• ElementNotFoundException – если не удалось дождаться открытия Mdi-формы

Returns

Форма

waitMdiForm

public Form waitMdiForm(String name, String representation, Duration duration)

Метод выполняет ожидание открытия MDI-формы с указанным именем и возвращает эту форму.

Если форма уже открыта, или открыты несколько форм с одним именем, будет возвращена ссылка на первую найденную форму.

Parameters

• name –

  Имя главной выборки формы.

  Примеры допустимых значений

  • gtk-ru.company.module.Module_SelectionName

  • gtk-Module_SelectionName

  • ru.company.module.Module_SelectionName

  • Module_SelectionName

• representation – Отображение главной выборки формы.

• duration – Длительность ожидания.

Throws

• ElementNotFoundException – если не удалось дождаться открытия Mdi-формы

Returns

Форма

waitModalForm

public Form waitModalForm(String name)

Метод выполняет ожидание открытия модальной формы с указанным именем и возвращает эту форму.

Parameters

• name –

  Имя формы.

  Примеры допустимых значений

  • gtk-ru.company.module.Module_SelectionName#Representation

  • gtk-Module_SelectionName#Representation

  • ru.company.module.Module_SelectionName#Representation

  • Module_SelectionName#Representation

  Если значение не будет содержать имени отображения, будет использовано значение по умолчанию Defaults.REPRESENTATION.

Throws

• ElementNotFoundException – если не удалось дождаться модальную форму

Returns

Форма

waitModalForm

public Form waitModalForm(String name, String representation)

Метод выполняет ожидание открытия модальной формы с указанным именем и возвращает эту форму.

Parameters

• name –

  Имя главной выборки формы.

  Примеры допустимых значений

  • gtk-ru.company.module.Module_SelectionName

  • gtk-Module_SelectionName

  • ru.company.module.Module_SelectionName

  • Module_SelectionName

• representation – Отображение главной выборки формы.

Throws

• ElementNotFoundException – если не удалось дождаться модальную форму

Returns

Форма

waitModalForm

public Form waitModalForm(String name, String representation, Duration duration)

Метод выполняет ожидание открытия модальной формы с указанным именем и возвращает эту форму.

Parameters

• name –

  Имя главной выборки формы.

  Примеры допустимых значений

  • gtk-ru.company.module.Module_SelectionName

  • gtk-Module_SelectionName

  • ru.company.module.Module_SelectionName

  • Module_SelectionName

• representation – Отображение главной выборки формы.

• duration – Длительность ожидания.

Throws

• ElementNotFoundException – если не удалось дождаться модальную форму

Returns

Форма

waitMsgDialog

public MsgDialog waitMsgDialog()

Метод выполняет ожидание открытия модального диалога MsgDialog с кнопками: OK, Да, Нет, Отмена и т.д..

Returns

Диалог