AbstractForm¶

public abstract class AbstractForm extends AbstractUiElement ¶: New in version 1.1.0: Добавлены методы ожидания выборки. Названия методов и их сигнатуры приведены к соглашению по именам (см. описания соответствующих методов).

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

See also

AbstractForm.OpenType

Constructors¶

AbstractForm¶

protected AbstractForm(BrowserContext browserContext, WebElement webElement)¶

Methods¶

find¶

static Optional<AbstractForm> find(BrowserContext browserContext, Name name, AbstractForm.OpenType openType)¶

New in version 1.1.0: Сигнатура приведена к соглашению по именам (ранее возвращалась форма, теперь возвращается опциональная форма).

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

Parameters:

browserContext – контекст браузера
name – имя формы
openType – тип открытия

Returns:

опциональная форма

findAll¶

static AbstractForm[] findAll(BrowserContext browserContext, AbstractForm.OpenType openType)¶

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

Parameters:

browserContext – контекст браузера
openType – тип открытия

Returns:

массив форм

See also

AbstractForm.OpenType

findAll¶

static AbstractForm[] findAll(BrowserContext browserContext)¶

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

Parameters:

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

Returns:

массив форм

findBySimpleName¶

static Optional<AbstractForm> findBySimpleName(BrowserContext browserContext, Name name, AbstractForm.OpenType openType)¶

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

Parameters:

browserContext – контекст браузера
name – простое имя формы
openType – тип открытия

Returns:

опциональная форма

See also

Name.getSimpleName()

get¶

static AbstractForm get(BrowserContext browserContext, Name name, AbstractForm.OpenType openType)¶

New in version 1.1.0.

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

Parameters:

browserContext – контекст браузера
name – имя формы
openType – тип открытия

Throws:

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

Returns:

форма

getBySimpleName¶

static AbstractForm getBySimpleName(BrowserContext browserContext, Name simpleName, AbstractForm.OpenType openType)¶

New in version 1.1.0.

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

Parameters:

browserContext – контекст браузера
simpleName – простое имя формы
openType – тип открытия

Throws:

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

Returns:

форма

See also

Name.getSimpleName()

getName¶

public String getName()¶

Возвращает имя формы.

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

Примеры возможных значений имён для MDI/Modal/Lookup-форм:

gtk-company.namespace.module.Module_SomeName#Representation
gtk@sbtname-company.namespace.module.Module_SomeName#Representation

Returns:: Имя формы

getOpenType¶

public AbstractForm.OpenType getOpenType()¶

Возвращает тип открытия формы.

Returns:: Тип открытия

getQualifiedName¶

public Name getQualifiedName()¶

Возвращает квалифицированное имя формы.

Returns:: Квалифицированное имя.

mainSelection¶

public Selection mainSelection()¶

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

Ищет на форме и возвращает главную выборку этой формы.

Throws:

ElementNotFoundException – если главная выборка не обнаружена на dom-модели

Returns:

Выборка.

selection¶

public Selection selection(String name)¶

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

Ищет на форме и возвращает выборку с указанными именем и отображением.

Parameters:

name – имя выборки

Throws:

ElementNotFoundException – если выборка на dom-модели не обнаружена

Returns:

Выборка

selection¶

public Selection selection(String name, String representation)¶

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

Ищет на форме и возвращает выборку с указанными именем и отображением.

Parameters:

name – имя выборки
representation – отображение

Throws:

ElementNotFoundException – если выборка на dom-модели не обнаружена

Returns:

Выборка

wait¶

static AbstractForm wait(BrowserContext browserContext, Name name, AbstractForm.OpenType openType)¶

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

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

Parameters:

browserContext – контекст браузера
name – имя формы
openType – тип открытия

Throws:

ElementNotFoundException – если не удалось дождаться появления формы на dom-модели

Returns:

Форма

wait¶

static AbstractForm wait(BrowserContext browserContext, Name name, AbstractForm.OpenType openType, Duration duration)¶

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

Parameters:

browserContext – контекст браузера
name – имя формы
openType – тип открытия
duration – длительность ожидания

Throws:

ElementNotFoundException – если не удалось дождаться появления формы на dom-модели

Returns:

Форма

waitBySimpleName¶

static AbstractForm waitBySimpleName(BrowserContext browserContext, Name name, AbstractForm.OpenType openType)¶

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

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

Parameters:

browserContext – контекст браузера
name – имя формы
openType – тип открытия

Throws:

ElementNotFoundException – если не удалось дождаться появления формы на dom-модели

Returns:

Форма

See also

Name.getSimpleName()

waitBySimpleName¶

static AbstractForm waitBySimpleName(BrowserContext browserContext, Name name, AbstractForm.OpenType openType, Duration duration)¶

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

Parameters:

browserContext – контекст браузера
name – имя формы
openType – тип открытия
duration – длительность ожидания

Throws:

ElementNotFoundException – если не удалось дождаться появления формы на dom-модели

Returns:

Форма

See also

Name.getSimpleName()

waitClosing¶

static void waitClosing(BrowserContext browserContext, Name name, AbstractForm.OpenType openType)¶

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

Метод ожидает закрытия формы с указанными именем и типом открытия.

Parameters:

browserContext – контекст браузера
name – имя формы
openType – тип открытия

Throws:

AutomationException – если не удалось дождаться закрытия формы

waitClosing¶

static void waitClosing(BrowserContext browserContext, Name name, AbstractForm.OpenType openType, Duration duration)¶

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

Метод ожидает закрытия формы с указанными именем и типом открытия.

Parameters:

browserContext – контекст браузера
name – имя формы
openType – тип открытия
duration – длительность ожидания закрытия

Throws:

AutomationException – если не удалось дождаться закрытия формы

waitClosingBySimpleName¶

static void waitClosingBySimpleName(BrowserContext browserContext, Name name, AbstractForm.OpenType openType)¶

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

Метод ожидает закрытия формы с указанными простым именем и типом открытия.

Parameters:

browserContext – контекст браузера
name – имя формы
openType – тип открытия

Throws:

AutomationException – если не удалось дождаться закрытия формы

waitClosingBySimpleName¶

static void waitClosingBySimpleName(BrowserContext browserContext, Name name, AbstractForm.OpenType openType, Duration duration)¶

Метод ожидает закрытия формы с указанными именем и типом открытия.

Parameters:

browserContext – контекст браузера
name – имя формы
openType – тип открытия
duration – длительность ожидания закрытия

Throws:

org.openqa.selenium.TimeoutException – если не удалось дождаться закрытия формы

waitSelection¶

public Selection waitSelection(String name)¶

New in version 1.1.0.

Ожидает появления на форме и возвращает выборку с указанными именем и отображением.

Parameters:

name – имя выборки

Throws:

ElementNotFoundException – если не удалось дождаться появления выборки на dom-модели

Returns:

Выборка

waitSelection¶

public Selection waitSelection(String name, String representation)¶

New in version 1.1.0.

Ожидает появления на форме и возвращает выборку с указанными именем и отображением.

Parameters:

name – имя выборки
representation – отображение

Throws:

ElementNotFoundException – если не удалось дождаться появления выборки на dom-модели

Returns:

Выборка