ODk Test Framework (версия 2.5.0)/io.bitbucket.dsmoons.framework.odk.wrappers/Element

Element

open class Element

Класс предоставляет методы взаимодействия с элементами на странице браузера. Экземпляры класса создаются методами PageBase.getElementByXpath, PageBase.getElementByClassName и другими методами getElementBy... класса PageBase

Constructors

Element

constructor(element: Element)

Конструктор для создания пользовательских классов элементов.

Types

Select

class Select

Внутренний класс с методами работы с тегом select.

Functions

assertAndAccumulateThat

fun assertAndAccumulateThat(func: Function<Element, Boolean>, errorMessage: String): Element

fun assertAndAccumulateThat(func: Function<Element, Boolean>, description: String, errorMessage: String): Element

Проверка истинности условия. Если условие ложно, то вызывается исключение, логируется сообщение об ошибке, но тест не останавливается.

assertThat

fun assertThat(func: Function<Element, Boolean>, errorMessage: String): Element

fun assertThat(func: Function<Element, Boolean>, description: String, errorMessage: String): Element

Проверка истинности условия. Если условие ложно, то вызывается исключение, логируется сообщение об ошибке, тест останавливается.

clear

fun clear(): Element

Очистка элемента (удаление текста из текстового поля, области текста и т.д.)

clearElementState

@JvmOverloads

fun clearElementState(clearParents: Boolean = false): Element

Очистка кэша элемента. Следующее обращение к элементу начнется с его поиска.

click

@JvmOverloads

fun click(withJS: Boolean = false): Element

Клик по элементу

count

fun count(): Int

Количество элементов с таким локатором

doubleClick

fun doubleClick(): Element

Двойной клик по элементу

download

@JvmOverloads

fun download(userCredentials: UsernamePasswordCredentials? = null): File

Скачивание файла по ссылке из атрибута "href" или "src" элемента

dragAndDropTo

fun dragAndDropTo(element: Element): Element

Перетягивание этого элемента на переданный элемент.

exists

fun exists(): Boolean

Проверка наличия элемента. Возвращает true, если элемент найден.

getCssValue

fun getCssValue(name: String): String

Получение значения css-свойства элемента

getDomAttribute

fun getDomAttribute(name: String): String

Получение значения Dom-атрибута элемента

getDomProperty

fun getDomProperty(name: String): String

Получение значения Dom-свойства элемента

getInnerHtml

fun getInnerHtml(): String

Получение html-разметки элемента

getLocation

fun getLocation(): Point

Получение координат элемента

getRectangle

fun getRectangle(): Rectangle

Получение размеров и координат элемента

getSelect

fun getSelect(): Element.Select

Возвращает объект с методами взаимодействия с тегом Select.

getSize

fun getSize(): Dimension

Получение размеров элемента

getTagName

fun getTagName(): String

Получение имени тега элемента

getText

fun getText(): String

Получение текста элемента

ifExists

fun ifExists(consumer: Consumer<Element>): Element

Если элемент присутствует на странице, метод выполняет переданные действия (consumer) над элементом

isDisplayed

fun isDisplayed(): Boolean

Получение значения свойства displayed элемента

isEnabled

fun isEnabled(): Boolean

Получение значения свойства enabled элемента

isHidden

fun isHidden(): Boolean

Метод возвращает признак скрытого элемента

notExists

fun notExists(): Boolean

Проверка отсутствия элемента. Возвращает true, если элемент не найден.

removeAttribute

fun removeAttribute(name: String): Element

Удаление атрибута элемента

rightClick

fun rightClick(): Element

Клик правой кнопкой мыши по элементу

scrollToBottom

fun scrollToBottom(): Element

Прокрутка элемента к низу экрана

scrollToCenter

fun scrollToCenter(): Element

Прокрутка элемента к центру экрана

scrollToTop

fun scrollToTop(): Element

Прокрутка элемента к верху экрана

sendKeys

@JvmOverloads

fun sendKeys(message: CharSequence, clear: Boolean = false): Element

Отправка сообщения в элемент.

sendPassword

fun sendPassword(pass: String): Element

Отправка пароля в элемент.

setAttribute

fun setAttribute(name: String, value: String): Element

Установка атрибута элементу

setCssValue

fun setCssValue(name: String, value: String): Element

Установка css-свойства элементу

setValue

fun setValue(message: String): Element

Отправка сообщения в элемент.

submit

fun submit(): <Error class: unknown class>

Отправка формы

takeScreenshot

fun takeScreenshot(): File?

Создание скриншота элемента. Скриншот добавляется в лог и отчет Allure

toList

fun toList(): List<Element>

Метод возвращает список элементов, найденных по локатору данного элемента.

toString

open override fun toString(): String

Описание элемента и его локатор в виде строки

toWebElement

@JvmOverloads

fun toWebElement(timeout: Duration = SettingsHelper.webDriverWaitElementTimeout): WebElement?

Получение объекта WebElement. Используется в связке с методом PageBase.performActions

uploadFile

fun uploadFile(vararg files: File): Element

Загрузка одного или нескольких файлов.

fun uploadFile(vararg files: String): Element

Загрузка одного или нескольких файлов

waitFor

@JvmOverloads

fun waitFor(func: Function<Element, Boolean>, needFail: Boolean = false): Element

fun waitFor(func: Function<Element, Boolean>, needFail: Boolean, waitingTime: Duration): Element

fun waitFor(func: Function<Element, Boolean>, needFail: Boolean, waitingTime: Duration?, interval: Duration): Element

Ожидание выполнения условия для элемента.

waitForExists

@JvmOverloads

fun waitForExists(needFail: Boolean = false): Element

fun waitForExists(needFail: Boolean, waitingTime: Duration): Element

Ожидание наличия элемента на странице.

waitForExistsAnd

@JvmOverloads

fun waitForExistsAnd(func: Function<Element, Boolean>, needFail: Boolean = false): Element

fun waitForExistsAnd(func: Function<Element, Boolean>, needFail: Boolean, waitingTime: Duration): Element

fun waitForExistsAnd(func: Function<Element, Boolean>, needFail: Boolean, waitingTime: Duration?, interval: Duration): Element

Ожидание наличия элемента на странице и выполнения условия для элемента.