AbstractForm#

public abstract class AbstractForm extends AbstractUiElement#

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

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

See also

Constructors#

AbstractForm#

protected AbstractForm(BrowserContext browserContext, WebElement webElement)#

Methods#

find#

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

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

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

  • name – имя формы

  • openType – тип открытия

Returns

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

findAll#

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

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

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

  • openType – тип открытия

Returns

массив форм

See also

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

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

get#

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

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

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

  • name – имя формы

  • openType – тип открытия

Throws
Returns

форма

getBySimpleName#

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

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

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

  • simpleName – простое имя формы

  • openType – тип открытия

Throws
Returns

форма

getName#

public String getName()#

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

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

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

Returns

Имя формы

getOpenType#

public AbstractForm.OpenType getOpenType()#

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

Returns

Тип открытия

getQualifiedName#

public Name getQualifiedName()#

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

Returns

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

mainSelection#

public Selection mainSelection()#

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

Throws
Returns

Выборка.

selection#

public Selection selection(String name)#

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

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

Throws
Returns

Выборка

selection#

public Selection selection(String name, String representation)#

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

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

  • representation – отображение

Throws
Returns

Выборка

wait#

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

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

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

  • name – имя формы

  • openType – тип открытия

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

Returns

Форма

wait#

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

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

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

  • name – имя формы

  • openType – тип открытия

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

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

Returns

Форма

waitBySimpleName#

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

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

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

  • name – имя формы

  • openType – тип открытия

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

Returns

Форма

waitBySimpleName#

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

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

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

  • name – имя формы

  • openType – тип открытия

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

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

Returns

Форма

waitClosing#

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

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

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

  • name – имя формы

  • openType – тип открытия

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

waitClosing#

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

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

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

  • name – имя формы

  • openType – тип открытия

  • duration – длительность ожидания закрытия

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

waitClosingBySimpleName#

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

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

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

waitSelection#

public Selection waitSelection(String name)#

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

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

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

Returns

Выборка

waitSelection#

public Selection waitSelection(String name, String representation)#

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

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

  • representation – отображение

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

Returns

Выборка