Link Search Menu Expand Document
Thekla

Interactions of Web and Mobile Abilities

Click

Clicks on the given browser element (mobile / desktop) or an app element (mobile).

the Tap interaction is not implemented, it will follow soon

Ability

Methods

name parameter description
.on()* element: SppElement click the element
.on.centered()* element: SppElement first scroll element to the viewports center then click it

Example 

Josh.attemptsTo(
    Click
        .on(Googles.SEARCH_BUTTON)
)

Josh.attemptsTo(
    Click
        .on.centered(Googles.SEARCH_BUTTON)
)

Drag

Ability

Methods

name parameter description
.method()* param: PARAMETER description

Example

Enter

Enters a value into a text field or area. To upload a file you are entering the file location into the uploads input field.

If the field contains already a value, the new value will be appended.

Ability

Methods

name parameter description
.value()* value: string the string value which will be entered into the element
.into() element: SppElement the input field or text area the value shall be entered into
.into.empty() element: SppElement remove all text from the field before entering the new value

Example

Enter new text into Googles search field.

Josh.attemptsTo(
    Enter
        .value("Software Test Automation")
        .into(Googles.SEARCH_FIELD)
)

Enter the text into the emptied field.

Josh.attemptsTo(
    Enter
        .value("Software Test Automation extreme")
        .into.empty(Googles.SEARCH_FIELD)
)

Hover

Move the mouse pointer over an element.

Ability

Methods

name parameter description
.over()* - move the mouse over the element

Example 

 Josh.attemptsTo(
     Hover
         .over(Googles.IMAGINARY_HOVER_ELEMENT)
 )

Load the an URL in the browser.

Ability

Methods

name parameter description
.to()* url: string browse to the given url

Example 

Josh.attemptsTo(
    Navigate
        .to("https://google.com")
)

Scroll

Ability

Methods

name parameter description
.to()* element: SppElement scroll the element to the top of the viewport
.to.centered()* element: SppElement scroll the element to the viewports center position
.atTheViewportCenter()   DEPRECATED
.toPosition()* position: PagePosition scroll to a page position, currently implemented are Page.bottom() and Page.top()

Example 

josh.attemptsTo(
    Scroll.to(MY_ELEMENT),
    Scroll.to(MY_ELEMENT).atTheViewportCenter(),

    Scroll.to(Page.top())
)

Tap NOT IMPLEMENTED YET

Tap on an element or position of an touch enabled device ( mobile or desktop / laptop).

Ability

Methods

name parameter description
.on()* element: SppElement or position: Point taps on an element or a screens position

Example 

Josh.attemptsTo(
    Tap.on(Googles.SEARCH_BUTTON),
    Tap.on(Position.onScreen(x,y))
)