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()¶: New in version 1.1.0.

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

forms¶

public AbstractForm[] forms()¶

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

Returns:: Массив форм

get¶

public static Application get(BrowserContext browserContext)¶

New in version 1.1.0: Переименовано согласно соглашению по именам (ранее метод назывался find).

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

Parameters:

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

Throws:

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

Returns:

Приложение

getKeyboardInputWebElement¶

public Optional<WebElement> getKeyboardInputWebElement()¶

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

Returns:: Optional.empty()

getServerAutomationSettings¶

public static Application.ServerAutomationSettings getServerAutomationSettings()¶

New in version 1.1.1.

Получить значения параметров автоматизации, сообщенные сервером приложений.

Returns:: объект значений параметров автоматизации

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)¶

New in version 1.1.0: Сигнатура метода приведена к соглашению по именам (ранее выбрасывались исключения типа NoSuchElementException).

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

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()¶

New in version 1.1.0.

Возвращает панель вкладок открытых 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()¶

New in version 1.1.0.

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

Throws:

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

Returns:

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

waitLookupForm¶

public Form waitLookupForm(String name)¶

New in version 1.1.0: Сигнатура метода приведена к соглашению по именам (ранее выбрасывались исключения типа TimeoutException).

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

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:: Диалог