org.alfresco.webdrone

Class HtmlElement

java.lang.Object

org.alfresco.webdrone.HtmlElement

public class HtmlElement
extends Object

A wrapper to add functionality to WebElement. The class allows to look within the WebElement by polling every 100 milliseconds to see if the elements if found.

Since:

1.3

Author:

Michael Suzuki

Field Summary

Fields

Modifier and Type	Field and Description
protected long	defaultWaitTime
protected WebDrone	drone
protected long	maxTime

Constructor Summary

Constructors

Constructor and Description
HtmlElement(WebDrone drone) Constructor.
HtmlElement(org.openqa.selenium.WebElement webElement, WebDrone drone) Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
protected boolean	canResume() Waits for site pop up message to disappear to allow the drone to resume operations on the page.
protected boolean	canResume(String elementCss, long waitTime) Waits for expected element to be displayed and available for action before drone resumes operations on the page.
String	click() Wrapper to web emlement click with added check to see if dom event complete.
String	domEventCompleted() Checks if page event action completed.
org.openqa.selenium.WebElement	find(org.openqa.selenium.By by) Find operation as found in the WebDrone find.
protected List<org.openqa.selenium.WebElement>	findAllWithWait(org.openqa.selenium.By by) Helper method to find a list of WebElement with a time limit in milliseconds.
org.openqa.selenium.WebElement	findAndWait(org.openqa.selenium.By by) Helper method to find a WebElement with a time limit in milliseconds.
org.openqa.selenium.WebElement	findElement(org.openqa.selenium.By by) Wrapper to WebElement findElement.
List<org.openqa.selenium.WebElement>	findElements(org.openqa.selenium.By by) Wrapper to WebElement findElements.
String	getAttribute(String attType) Wrapper to WebElement get attribute value of web element.
WebDrone	getDrone()
org.openqa.selenium.WebElement	getWebElement()
void	setWebElement(org.openqa.selenium.WebElement webElement)

Methods inherited from class java.lang.Object

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

Field Detail

maxTime

protected final long maxTime

defaultWaitTime

protected final long defaultWaitTime

drone

protected WebDrone drone

Constructor Detail

HtmlElement

public HtmlElement(WebDrone drone)

Constructor.

Parameters:

webElement - WebElement

HtmlElement

public HtmlElement(org.openqa.selenium.WebElement webElement,
           WebDrone drone)

Constructor.

Parameters:

webElement - WebElement

Method Detail

getDrone

public WebDrone getDrone()

findAndWait

public org.openqa.selenium.WebElement findAndWait(org.openqa.selenium.By by)

Helper method to find a WebElement with a time limit in milliseconds. During the wait period it will check for the element every 100 millisecond.

Parameters:

by - By criteria to search by

millisecond - time limit

Returns:

WebElement HTML element

getAttribute

public String getAttribute(String attType)

Wrapper to WebElement get attribute value of web element.

Parameters:

attType - String html attribute class, id or name

Returns:

String value of html attribute

findElement

public org.openqa.selenium.WebElement findElement(org.openqa.selenium.By by)

Wrapper to WebElement findElement.

Parameters:

By - by selector type.

Returns:

WebElement html element

findElements

public List<org.openqa.selenium.WebElement> findElements(org.openqa.selenium.By by)

Wrapper to WebElement findElements.

Parameters:

By - by selector type.

Returns:

collection ofWebElement html element

findAllWithWait

protected List<org.openqa.selenium.WebElement> findAllWithWait(org.openqa.selenium.By by)

Helper method to find a list of WebElement with a time limit in milliseconds. During the wait period it will check for the element every 100 millisecond.

Parameters:

by - By criteria to search by

millisecond - time limit

Returns:

List HTML element

canResume

protected boolean canResume(String elementCss,
                long waitTime)

Waits for expected element to be displayed and available for action before drone resumes operations on the page.

Parameters:

elementCss - String css identifier for the element

waitTime - timer in milliseconds

Returns:

true if element is available for operation

getWebElement

public org.openqa.selenium.WebElement getWebElement()

setWebElement

public void setWebElement(org.openqa.selenium.WebElement webElement)

domEventCompleted

public String domEventCompleted()

Checks if page event action completed. For further information see: https://dvcs.w3.org/hg/webperf/raw-file/tip/specs/NavigationTiming/Overview.html

Returns:

String time took to complete event

click

public String click()

Wrapper to web emlement click with added check to see if dom event complete.

Returns:

String duration of dom event

find

public org.openqa.selenium.WebElement find(org.openqa.selenium.By by)

Find operation as found in the WebDrone find. We have introduced the find wrapper to be used in instances were the html dom changes too much to have the webelement find hence we call on the driver to find the element.

Parameters:

by - Selector

Returns:

WebElement

canResume

protected boolean canResume()

Waits for site pop up message to disappear to allow the drone to resume operations on the page.

Parameters:

waitTime - timer in milliseconds

Returns:

true if message has gone