au.com.agic.apptesting.steps

Class ClickingStepDefinitions

java.lang.Object

au.com.agic.apptesting.steps.ClickingStepDefinitions

@Component
public class ClickingStepDefinitions
extends java.lang.Object

Gherkin steps used to click elements. These steps have Atom snipptets that start with the prefix "click". See https://github.com/mcasperson/iridium-snippets for more details.

Constructor Summary

Constructors

Constructor and Description
ClickingStepDefinitions()

Method Summary

Modifier and Type	Method and Description
void	clickCancelOnAlert(java.lang.String exists) Clicks cancel on the alert
void	clickElementSimpleStep(java.lang.String alias, java.lang.String selectorValue, java.lang.String exists) A simplified step that will click on an element found by ID attribute, name attribue, class attribute, xpath or CSS selector.
void	clickElementStep(java.lang.String selector, java.lang.String alias, java.lang.String selectorValue, java.lang.String exists) Clicks on an element
void	clickElementWithAttrStep(java.lang.String attributeNameAlias, java.lang.String attributeName, java.lang.String attributeValueAlias, java.lang.String attributeValue, java.lang.String exists) Clicks an element on the page selected via its attributes
void	clickElementWithRandomNumberStep(java.lang.String attributeNameAlias, java.lang.String attributeName, java.lang.String randomStartAlias, java.lang.String randomStart, java.lang.String randomEndAlias, java.lang.String randomEnd, java.lang.String exists) Clicks on an element with a random number
void	clickHiddenElementStep(java.lang.String selector, java.lang.String alias, java.lang.String selectorValue, java.lang.String exists) Clicks on an element that may or may not be visible on the page
void	clickHiddenLinkStep(java.lang.String alias, java.lang.String linkContent, java.lang.String exists) Clicks a link that may or may not be visible on the page
void	clickInElement(java.lang.String event, java.lang.Float xAxis, java.lang.Float yAxis, java.lang.String alias, java.lang.String selectorValue, java.lang.String exists) Clicks within the area of an element.
void	clickLinkStep(java.lang.String alias, java.lang.String linkContent, java.lang.String exists) Clicks a link on the page
void	clickOKOnAlert(java.lang.String exists) Clicks ok on the alert
void	clickSimpleHiddenElementStep(java.lang.String alias, java.lang.String selectorValue, java.lang.String exists) Selects an element with simplified selection and clicks on an it regardless of wether is is or is not be visible on the page

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ClickingStepDefinitions

public ClickingStepDefinitions()

Method Detail

clickElementSimpleStep

@When(value="^I click (?:a|an|the) element found by( alias)? \"([^\"]*)\"( if it exists)?$")
public void clickElementSimpleStep(java.lang.String alias,
                                                                                                                                 java.lang.String selectorValue,
                                                                                                                                 java.lang.String exists)

A simplified step that will click on an element found by ID attribute, name attribue, class attribute, xpath or CSS selector. The first element to satisfy any of those conditions will be the one that the step interacts with. It is up to the caller to ensure that the selection is unique.

Parameters:

alias - If this word is found in the step, it means the selectorValue is found from the data set.

selectorValue - The value used in conjunction with the selector to match the element. If alias was set, this value is found from the data set. Otherwise it is a literal value.

exists - If this text is set, an error that would be thrown because the element was not found is ignored. Essentially setting this text makes this an optional statement.

clickElementStep

@When(value="^I click (?:a|an|the) element with (?:a|an|the) (ID|class|xpath|name|css selector)( alias)? of \"([^\"]*)\"( if it exists)?$")
public void clickElementStep(java.lang.String selector,
                                                                                                                                                                          java.lang.String alias,
                                                                                                                                                                          java.lang.String selectorValue,
                                                                                                                                                                          java.lang.String exists)

Clicks on an element

Parameters:

selector - Either ID, class, xpath, name or css selector

alias - If this word is found in the step, it means the selectorValue is found from the data set.

selectorValue - The value used in conjunction with the selector to match the element. If alias was set, this value is found from the data set. Otherwise it is a literal value.

exists - If this text is set, an error that would be thrown because the element was not found is ignored. Essentially setting this text makes this an optional statement.

clickSimpleHiddenElementStep

@When(value="^I click (?:a|an|the) hidden element found by( alias)? \"([^\"]*)\"( if it exists)?$")
public void clickSimpleHiddenElementStep(java.lang.String alias,
                                                                                                                                              java.lang.String selectorValue,
                                                                                                                                              java.lang.String exists)

Selects an element with simplified selection and clicks on an it regardless of wether is is or is not be visible on the page

Parameters:

alias - If this word is found in the step, it means the selectorValue is found from the data set.

selectorValue - The value used in conjunction with the selector to match the element. If alias was set, this value is found from the data set. Otherwise it is a literal value.

exists - If this text is set, an error that would be thrown because the element was not found is ignored. Essentially setting this text makes this an optional statement.

clickHiddenElementStep

@When(value="^I click (?:a|an|the) hidden element with (?:a|an|the) (ID|class|xpath|name|css selector)( alias)? of \"([^\"]*)\"( if it exists)?$")
public void clickHiddenElementStep(java.lang.String selector,
                                                                                                                                                                                       java.lang.String alias,
                                                                                                                                                                                       java.lang.String selectorValue,
                                                                                                                                                                                       java.lang.String exists)

Clicks on an element that may or may not be visible on the page

Parameters:

selector - Either ID, class, xpath, name or css selector

alias - If this word is found in the step, it means the selectorValue is found from the data set.

selectorValue - The value used in conjunction with the selector to match the element. If alias was set, this value is found from the data set. Otherwise it is a literal value.

exists - If this text is set, an error that would be thrown because the element was not found is ignored. Essentially setting this text makes this an optional statement.

clickLinkStep

@When(value="^I click (?:a|an|the) link with the text content of( alias)? \"([^\"]*)\"( if it exists)?$")
public void clickLinkStep(java.lang.String alias,
                                                                                                                                     java.lang.String linkContent,
                                                                                                                                     java.lang.String exists)

Clicks a link on the page

Parameters:

alias - If this word is found in the step, it means the linkContent is found from the data set.

linkContent - The text content of the link we are clicking

exists - If this text is set, an error that would be thrown because the element was not found is ignored. Essentially setting this text makes this an optional statement.

clickHiddenLinkStep

@When(value="^I click (?:a|an|the) hidden link with the text content( alias)? of \"([^\"]*)\"( if it exists)?$")
public void clickHiddenLinkStep(java.lang.String alias,
                                                                                                                                                  java.lang.String linkContent,
                                                                                                                                                  java.lang.String exists)

Clicks a link that may or may not be visible on the page

Parameters:

alias - If this word is found in the step, it means the linkContent is found from the data set.

linkContent - The text content of the link we are clicking

exists - If this text is set, an error that would be thrown because the element was not found is ignored. Essentially setting this text makes this an optional statement.

clickElementWithRandomNumberStep

@When(value="^I click (?:a|an|the) element with (?:a|an|the) attribute( alias)? of \"([^\"]*)\" with a random number between( alias)? \"([^\"]*)\" and( alias)? \"([^\"]*)\"( if it exists)?$")
public void clickElementWithRandomNumberStep(java.lang.String attributeNameAlias,
                                                                                                                                                                                                                                              java.lang.String attributeName,
                                                                                                                                                                                                                                              java.lang.String randomStartAlias,
                                                                                                                                                                                                                                              java.lang.String randomStart,
                                                                                                                                                                                                                                              java.lang.String randomEndAlias,
                                                                                                                                                                                                                                              java.lang.String randomEnd,
                                                                                                                                                                                                                                              java.lang.String exists)

Clicks on an element with a random number

Parameters:

attributeName - Either ID, class, xpath, name or css selector

attributeNameAlias - If this word is found in the step, it means the selectorValue is found from the data set.

randomStartAlias - If this word is found in the step, it means the randomStart is found from the data set.

randomStart - The start of the range of random numbers to select from

randomEndAlias - If this word is found in the step, it means the randomEnd is found from the data set.

randomEnd - The end of the range of random numbers to select from

exists - If this text is set, an error that would be thrown because the element was not found is ignored. Essentially setting this text makes this an optional statement.

clickElementWithAttrStep

@When(value="^I click (?:a|an|the) element with (?:a|an|the) attribute( alias)? of \"([^\"]*)\" equal to( alias)? \"([^\"]*)\"( if it exists)?$")
public void clickElementWithAttrStep(java.lang.String attributeNameAlias,
                                                                                                                                                                                        java.lang.String attributeName,
                                                                                                                                                                                        java.lang.String attributeValueAlias,
                                                                                                                                                                                        java.lang.String attributeValue,
                                                                                                                                                                                        java.lang.String exists)

Clicks an element on the page selected via its attributes

Parameters:

attributeNameAlias - If this word is found in the step, it means the attributeName is found from the data set.

attributeName - The name of the attribute to match.

attributeValueAlias - If this word is found in the step, it means the attributeValue is found from the data set.

attributeValue - The value of the attribute to match

exists - If this text is set, an error that would be thrown because the element was not found is ignored. Essentially setting this text makes this an optional statement.

clickOKOnAlert

@When(value="^I click \"OK\" on the alert( if it exists)?$")
public void clickOKOnAlert(java.lang.String exists)

Clicks ok on the alert

Parameters:

exists - If this text is set, an error that would be thrown because the element was not found is ignored. Essentially setting this text makes this an optional statement.

clickCancelOnAlert

@When(value="^I click \"Cancel\" on the alert( if it exists)?$")
public void clickCancelOnAlert(java.lang.String exists)

Clicks cancel on the alert

Parameters:

exists - If this text is set, an error that would be thrown because the element was not found is ignored. Essentially setting this text makes this an optional statement.

clickInElement

@When(value="^I \"(click|mousedown|mouseup|mouseover|mouseout|mousemove|dblclick)\" \"(\\d+(?:\\.\\d+)?)%\" horizontally and \"(\\d+(?:\\.\\d+)?)%\" vertically within the area of (?:a|an|the) element found by( alias)? \"([^\"]*)\"( if it exists)?$")
public void clickInElement(java.lang.String event,
                                                                                                                                                                                                                                                                                      java.lang.Float xAxis,
                                                                                                                                                                                                                                                                                      java.lang.Float yAxis,
                                                                                                                                                                                                                                                                                      java.lang.String alias,
                                                                                                                                                                                                                                                                                      java.lang.String selectorValue,
                                                                                                                                                                                                                                                                                      java.lang.String exists)

Clicks within the area of an element. This is useful for UI widgets like sliders.

Parameters:

event - The kind of mouse event to trigger

xAxis - The horizontal percentage within the element area to click

yAxis - The vertical percentage within the element area to click

alias - Include this to force the selector to reference an alias

selectorValue - The selector

exists - Include this to ignore errors caused by missing elements