com.opera.core.systems

Class OperaWebElement

java.lang.Object

org.openqa.selenium.remote.RemoteWebElement

com.opera.core.systems.OperaWebElement

All Implemented Interfaces:

CapturesScreen, org.openqa.selenium.internal.FindsByClassName, org.openqa.selenium.internal.FindsByCssSelector, org.openqa.selenium.internal.FindsById, org.openqa.selenium.internal.FindsByLinkText, org.openqa.selenium.internal.FindsByName, org.openqa.selenium.internal.FindsByTagName, org.openqa.selenium.internal.FindsByXPath, org.openqa.selenium.internal.Locatable, org.openqa.selenium.internal.WrapsDriver, org.openqa.selenium.SearchContext, org.openqa.selenium.WebElement

public class OperaWebElement
extends org.openqa.selenium.remote.RemoteWebElement
implements CapturesScreen

Implements WebDriver's WebElement, but also extends it with Opera specific methods.

Field Summary

Fields

Modifier and Type	Field and Description
static List<String>	SPECIAL_INPUTS

Fields inherited from class org.openqa.selenium.remote.RemoteWebElement

fileDetector, id, mouse

Constructor Summary

Constructors

Constructor and Description
OperaWebElement(OperaDriver driver, int id)

Method Summary

Methods

Modifier and Type	Method and Description
String	callMethod(String method) Calls the method and parses the result, the result must be a string
ScreenCaptureReply	captureScreen() Takes a screen capture of the whole screen, including the areas outside of the viewport and the browser window.
ScreenCaptureReply	captureScreen(long timeout) Takes a screen capture of the whole screen, including the areas outside of the viewport and the browser window.
ScreenCaptureReply	captureScreen(long timeout, List<String> knownMD5s) Takes a screen capture of the whole screen, including the areas outside of the viewport and the browser window.
void	clear()
void	click()
boolean	containsColor(OperaColors... colors) Deprecated.
protected void	finalize()
org.openqa.selenium.WebElement	findElement(org.openqa.selenium.By by)
protected org.openqa.selenium.WebElement	findElement(String by, String using)
org.openqa.selenium.WebElement	findElementByName(String using)
List<org.openqa.selenium.WebElement>	findElements(org.openqa.selenium.By by)
protected List<org.openqa.selenium.WebElement>	findElements(String by, String using)
List<org.openqa.selenium.WebElement>	findElementsByName(String using)
String	getAttribute(String attribute)
org.openqa.selenium.interactions.internal.Coordinates	getCoordinates()
String	getCssValue(String property)
String	getImageHash() Takes a screenshot of the area this element's bounding-box covers and returns the MD5 hash.
String	getImageHash(long timeout, List<String> hashes) Takes a screenshot after timeout milliseconds of the area this element's bounding-box covers and returns the MD5 hash.
org.openqa.selenium.Point	getLocation() Click top left, can be modified to click in the middle
org.openqa.selenium.Point	getLocationOnScreenOnceScrolledIntoView() Deprecated. To be removed in selenium 2.31. Use getCoordinates() instead
int	getObjectId()
int	getRuntimeId()
org.openqa.selenium.Dimension	getSize()
String	getTagName()
String	getText()
org.openqa.selenium.WebDriver	getWrappedDriver()
int	hashCode()
boolean	isDisplayed()
boolean	isEnabled()
boolean	isSelected()
void	middleClick() Deprecated.
String	saveScreenshot(String filename) Take a screenshot of the area this element's bounding-box covers.
String	saveScreenshot(String filename, long timeout) Take a screenshot of the area this element covers.
String	saveScreenshot(String filename, long timeout, boolean includeImage, List<String> hashes) Take a screenshot of the area this element covers.
void	sendKeys(CharSequence... keysToSend)
void	submit()
String	toString()

Methods inherited from class org.openqa.selenium.remote.RemoteWebElement

equals, execute, findElementByClassName, findElementByCssSelector, findElementById, findElementByLinkText, findElementByPartialLinkText, findElementByTagName, findElementByXPath, findElementsByClassName, findElementsByCssSelector, findElementsById, findElementsByLinkText, findElementsByPartialLinkText, findElementsByTagName, findElementsByXPath, getId, setFileDetector, setFoundBy, setId, setParent

Methods inherited from class java.lang.Object

clone, getClass, notify, notifyAll, wait, wait, wait

Field Detail

SPECIAL_INPUTS

public static final List<String> SPECIAL_INPUTS

Constructor Detail

OperaWebElement

public OperaWebElement(OperaDriver driver,
               int id)

Parameters:

driver - driver that this element belongs to

id - the ECMAScript object ID of this element

Method Detail

callMethod

public final String callMethod(String method)

Calls the method and parses the result, the result must be a string

Parameters:

method - the method to call

Returns:

response of ECMAScript in string presentation

click

public void click()

Specified by:

click in interface org.openqa.selenium.WebElement

Overrides:

click in class org.openqa.selenium.remote.RemoteWebElement

middleClick

@Deprecated
public void middleClick()

Deprecated.

Click the middle mouse button at the top left corner of the element. Will not verify whether element is available for interaction first.

findElement

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

Specified by:

findElement in interface org.openqa.selenium.SearchContext

Specified by:

findElement in interface org.openqa.selenium.WebElement

Overrides:

findElement in class org.openqa.selenium.remote.RemoteWebElement

findElements

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

Specified by:

findElements in interface org.openqa.selenium.SearchContext

Specified by:

findElements in interface org.openqa.selenium.WebElement

Overrides:

findElements in class org.openqa.selenium.remote.RemoteWebElement

getAttribute

public String getAttribute(String attribute)

Specified by:

getAttribute in interface org.openqa.selenium.WebElement

Overrides:

getAttribute in class org.openqa.selenium.remote.RemoteWebElement

getText

public String getText()

Specified by:

getText in interface org.openqa.selenium.WebElement

Overrides:

getText in class org.openqa.selenium.remote.RemoteWebElement

isDisplayed

public boolean isDisplayed()

Specified by:

isDisplayed in interface org.openqa.selenium.WebElement

Overrides:

isDisplayed in class org.openqa.selenium.remote.RemoteWebElement

isEnabled

public boolean isEnabled()

Specified by:

isEnabled in interface org.openqa.selenium.WebElement

Overrides:

isEnabled in class org.openqa.selenium.remote.RemoteWebElement

isSelected

public boolean isSelected()

Specified by:

isSelected in interface org.openqa.selenium.WebElement

Overrides:

isSelected in class org.openqa.selenium.remote.RemoteWebElement

clear

public void clear()

Specified by:

clear in interface org.openqa.selenium.WebElement

Overrides:

clear in class org.openqa.selenium.remote.RemoteWebElement

sendKeys

public void sendKeys(CharSequence... keysToSend)

Specified by:

sendKeys in interface org.openqa.selenium.WebElement

Overrides:

sendKeys in class org.openqa.selenium.remote.RemoteWebElement

submit

public void submit()

Specified by:

submit in interface org.openqa.selenium.WebElement

Overrides:

submit in class org.openqa.selenium.remote.RemoteWebElement

getLocation

public org.openqa.selenium.Point getLocation()

Click top left, can be modified to click in the middle

Specified by:

getLocation in interface org.openqa.selenium.WebElement

Overrides:

getLocation in class org.openqa.selenium.remote.RemoteWebElement

getSize

public org.openqa.selenium.Dimension getSize()

Specified by:

getSize in interface org.openqa.selenium.WebElement

Overrides:

getSize in class org.openqa.selenium.remote.RemoteWebElement

getImageHash

public String getImageHash()

Takes a screenshot of the area this element's bounding-box covers and returns the MD5 hash.

Returns:

an MD5 hash as a string

getImageHash

public String getImageHash(long timeout,
                  List<String> hashes)

Takes a screenshot after timeout milliseconds of the area this element's bounding-box covers and returns the MD5 hash.

Parameters:

timeout - the number of milliseconds to wait before taking the screenshot

hashes - optional hashes to compare the hashes with

Returns:

an MD5 hash as a string

saveScreenshot

public String saveScreenshot(String filename)

Take a screenshot of the area this element's bounding-box covers. Saves a copy of the image to the given filename, and returns an MD5 hash of the image.

Parameters:

filename - the location to save the screenshot

Returns:

the MD5 hash of the screenshot

saveScreenshot

public String saveScreenshot(String filename,
                    long timeout)

Take a screenshot of the area this element covers. Saves a copy of the image to the given filename.

Parameters:

filename - the location to save the screenshot

timeout - the number of milliseconds to wait before taking the screenshot

Returns:

the MD5 hash of the screenshot

saveScreenshot

public String saveScreenshot(String filename,
                    long timeout,
                    boolean includeImage,
                    List<String> hashes)

Take a screenshot of the area this element covers. If the hash of the image matches any of the given hashes then no image is saved, otherwise it saves a copy of the image to the given filename.

Parameters:

filename - the location to save the screenshot

timeout - the number of milliseconds to wait before taking the screenshot

includeImage - whether to get the image data. Disable if you just need the MD5 hash

hashes - known image hashes

Returns:

the MD5 hash of the screenshot

captureScreen

public ScreenCaptureReply captureScreen()

Description copied from interface: CapturesScreen

Takes a screen capture of the whole screen, including the areas outside of the viewport and the browser window.

Specified by:

captureScreen in interface CapturesScreen

Returns:

a screen capture reply

captureScreen

public ScreenCaptureReply captureScreen(long timeout)

Description copied from interface: CapturesScreen

Takes a screen capture of the whole screen, including the areas outside of the viewport and the browser window.

Specified by:

captureScreen in interface CapturesScreen

Parameters:

timeout - the number of milliseconds to wait before taking the screenshot

Returns:

a screen capture reply

captureScreen

public ScreenCaptureReply captureScreen(long timeout,
                               List<String> knownMD5s)

Description copied from interface: CapturesScreen

Takes a screen capture of the whole screen, including the areas outside of the viewport and the browser window.

Specified by:

captureScreen in interface CapturesScreen

Parameters:

timeout - the number of milliseconds to wait before taking the screenshot

knownMD5s - a list of previous screenshots' MD5 hashes; if they match the hash of this screenshot then no image data is returned

Returns:

a screen capture reply

containsColor

@Deprecated
public boolean containsColor(OperaColors... colors)

Deprecated.

Check if the current page contains any of the given colors. Used on tests that use red to show a failure.

Parameters:

colors - list of colors to check for

Returns:

true if the page contains any of the given colors, false otherwise

getTagName

public String getTagName()

Specified by:

getTagName in interface org.openqa.selenium.WebElement

Overrides:

getTagName in class org.openqa.selenium.remote.RemoteWebElement

getLocationOnScreenOnceScrolledIntoView

@Deprecated
public org.openqa.selenium.Point getLocationOnScreenOnceScrolledIntoView()

Deprecated. To be removed in selenium 2.31. Use getCoordinates() instead

getObjectId

public int getObjectId()

getRuntimeId

public int getRuntimeId()

hashCode

public int hashCode()

Overrides:

hashCode in class org.openqa.selenium.remote.RemoteWebElement

toString

public String toString()

Overrides:

toString in class org.openqa.selenium.remote.RemoteWebElement

findElement

protected org.openqa.selenium.WebElement findElement(String by,
                                         String using)

Overrides:

findElement in class org.openqa.selenium.remote.RemoteWebElement

findElements

protected List<org.openqa.selenium.WebElement> findElements(String by,
                                                String using)

Overrides:

findElements in class org.openqa.selenium.remote.RemoteWebElement

findElementByName

public org.openqa.selenium.WebElement findElementByName(String using)

Specified by:

findElementByName in interface org.openqa.selenium.internal.FindsByName

Overrides:

findElementByName in class org.openqa.selenium.remote.RemoteWebElement

findElementsByName

public List<org.openqa.selenium.WebElement> findElementsByName(String using)

Specified by:

findElementsByName in interface org.openqa.selenium.internal.FindsByName

Overrides:

findElementsByName in class org.openqa.selenium.remote.RemoteWebElement

finalize

protected void finalize()
                 throws Throwable

Overrides:

finalize in class Object

Throws:

Throwable

getCoordinates

public org.openqa.selenium.interactions.internal.Coordinates getCoordinates()

Specified by:

getCoordinates in interface org.openqa.selenium.internal.Locatable

Overrides:

getCoordinates in class org.openqa.selenium.remote.RemoteWebElement

getCssValue

public String getCssValue(String property)

Specified by:

getCssValue in interface org.openqa.selenium.WebElement

Overrides:

getCssValue in class org.openqa.selenium.remote.RemoteWebElement

getWrappedDriver

public org.openqa.selenium.WebDriver getWrappedDriver()

Specified by:

getWrappedDriver in interface org.openqa.selenium.internal.WrapsDriver

Overrides:

getWrappedDriver in class org.openqa.selenium.remote.RemoteWebElement