com.workfusion.rpa.helpers

Class UiSelectors

java.lang.Object

com.workfusion.rpa.helpers.UiSelectors

public class UiSelectors
extends java.lang.Object

This class adds static methods for quick simplified creation of RPA selectors.

Samples

$(withText("Create Invoice")).shouldBe(visible, enabled);

$$(byTagName("A")).shouldHaveSize(5);

$(byXpath("//html/body/div[5]")).doubleClick();

Method Summary

Modifier and Type	Method and Description
static By	by(java.lang.String attributeName, java.lang.String attributeValue) Synonym for #byAttribute Seems to work incorrectly in HtmlUnit and PhantomJS if attribute name contains dash (e.g.
static By	byAttribute(java.lang.String attributeName, java.lang.String attributeValue) Find elements having attribute with given value.
static By	byClassName(java.lang.String className)
static By	byCssSelector(java.lang.String css)
static By	byId(java.lang.String id)
static By	byImage(java.lang.String imageUrl) Finds the first image element matching given URL.
static By	byImage(java.lang.String imageUrl, int offsetX, int offsetY) Finds the first image element matching given URL.
static By	byLinkText(java.lang.String linkText)
static By	byName(java.lang.String name)
static By	byPartialLinkText(java.lang.String partialLinkText)
static By	byTagName(java.lang.String name)
static By	byText(java.lang.String elementText) Find element that has EXACTLY this text NB! It seems that Selenium WebDriver does not support i18n characters in XPath :(
static By	byTitle(java.lang.String title) Find element with given title ("title" attribute)
static By	byValue(java.lang.String value) Find input element with given value ("value" attribute)
static By	byXpath(java.lang.String xpath)
static By	withText(java.lang.String elementText) Find element CONTAINING given text (as a substring) NB! It seems that Selenium WebDriver does not support i18n characters in XPath :(

Methods inherited from class java.lang.Object

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

Method Detail

withText

public static By withText(java.lang.String elementText)

Find element CONTAINING given text (as a substring) NB! It seems that Selenium WebDriver does not support i18n characters in XPath :(

Parameters:

elementText - Text to search inside element

Returns:

standard selenium By criteria`

byText

public static By byText(java.lang.String elementText)

Find element that has EXACTLY this text NB! It seems that Selenium WebDriver does not support i18n characters in XPath :(

Parameters:

elementText - Text that searched element should have

Returns:

standard selenium By criteria

byImage

public static By byImage(java.lang.String imageUrl)

Finds the first image element matching given URL. All the actions that rely on image location will use image center coordinates.

Parameters:

imageUrl - image URL

Returns:

image-based criteria

byImage

public static By byImage(java.lang.String imageUrl,
                         int offsetX,
                         int offsetY)

Finds the first image element matching given URL. All the actions that rely on image location will be corrected according to provided offsets. Offsets are calculated from the center of the image.

Parameters:

imageUrl - image URL

offsetX - horizontal offset from the center of the image

offsetY - vertical offset from the center of the image

Returns:

image-based criteria

byAttribute

public static By byAttribute(java.lang.String attributeName,
                             java.lang.String attributeValue)

Find elements having attribute with given value. Seems to work incorrectly if attribute name contains dash, for example: <option data-mailServerId="123"></option>

Parameters:

attributeName - name of attribute, should not be empty or null

attributeValue - value of attribute, should not contain both apostrophes and quotes

Returns:

standard selenium By criteria

by

public static By by(java.lang.String attributeName,
                    java.lang.String attributeValue)

Synonym for #byAttribute Seems to work incorrectly in HtmlUnit and PhantomJS if attribute name contains dash (e.g. "data-mailServerId")

byTitle

public static By byTitle(java.lang.String title)

Find element with given title ("title" attribute)

byValue

public static By byValue(java.lang.String value)

Find input element with given value ("value" attribute)

byName

public static By byName(java.lang.String name)

See Also:

By#name(java.lang.String)

byTagName

public static By byTagName(java.lang.String name)

See Also:

By#tagName(java.lang.String)

byXpath

public static By byXpath(java.lang.String xpath)

See Also:

By#xpath(java.lang.String)

byLinkText

public static By byLinkText(java.lang.String linkText)

See Also:

By#linkText(java.lang.String)

byPartialLinkText

public static By byPartialLinkText(java.lang.String partialLinkText)

See Also:

By#partialLinkText(java.lang.String)

byId

public static By byId(java.lang.String id)

See Also:

By#id(java.lang.String)

byCssSelector

public static By byCssSelector(java.lang.String css)

See Also:

By#cssSelector(java.lang.String)

byClassName

public static By byClassName(java.lang.String className)

See Also:

By#className(java.lang.String)