com.applitools.eyes.selenium.wrappers

Class EyesSeleniumDriver

java.lang.Object

com.applitools.eyes.selenium.wrappers.EyesWebDriver

com.applitools.eyes.selenium.wrappers.EyesSeleniumDriver

All Implemented Interfaces:

com.applitools.eyes.IEyesJsExecutor, org.openqa.selenium.HasCapabilities, org.openqa.selenium.interactions.HasInputDevices, org.openqa.selenium.interactions.HasTouchScreen, org.openqa.selenium.JavascriptExecutor, org.openqa.selenium.SearchContext, org.openqa.selenium.TakesScreenshot, org.openqa.selenium.WebDriver

public class EyesSeleniumDriver
extends EyesWebDriver
implements org.openqa.selenium.interactions.HasInputDevices, org.openqa.selenium.interactions.HasTouchScreen, com.applitools.eyes.IEyesJsExecutor

An SeleniumEyes implementation of the interfaces implemented by RemoteWebDriver. Used so we'll be able to return the users an object with the same functionality as RemoteWebDriver.

Nested Class Summary

Nested classes/interfaces inherited from interface org.openqa.selenium.WebDriver

org.openqa.selenium.WebDriver.ImeHandler, org.openqa.selenium.WebDriver.Navigation, org.openqa.selenium.WebDriver.Options, org.openqa.selenium.WebDriver.TargetLocator, org.openqa.selenium.WebDriver.Timeouts, org.openqa.selenium.WebDriver.Window

Field Summary

Fields inherited from class com.applitools.eyes.selenium.wrappers.EyesWebDriver

logger

Constructor Summary

Constructors

Constructor and Description
EyesSeleniumDriver(com.applitools.eyes.Logger logger, SeleniumEyes eyes, org.openqa.selenium.remote.RemoteWebDriver driver)

Method Summary

Modifier and Type	Method and Description
void	close()
Object	executeAsyncScript(String script, Object... args)
Object	executeScript(String script, Object... args)
org.openqa.selenium.WebElement	findElement(org.openqa.selenium.By by)
org.openqa.selenium.WebElement	findElementByClassName(String className)
org.openqa.selenium.WebElement	findElementByCssSelector(String cssSelector)
org.openqa.selenium.WebElement	findElementById(String id)
org.openqa.selenium.WebElement	findElementByLinkText(String linkText)
org.openqa.selenium.WebElement	findElementByName(String name)
org.openqa.selenium.WebElement	findElementByPartialLinkText(String partialLinkText)
org.openqa.selenium.WebElement	findElementByTagName(String tagName)
org.openqa.selenium.WebElement	findElementByXPath(String path)
List<org.openqa.selenium.WebElement>	findElements(org.openqa.selenium.By by)
List<org.openqa.selenium.WebElement>	findElementsByClassName(String className)
List<org.openqa.selenium.WebElement>	findElementsByCssSelector(String cssSelector)
List<org.openqa.selenium.WebElement>	findElementsById(String id)
List<org.openqa.selenium.WebElement>	findElementsByLinkText(String linkText)
List<org.openqa.selenium.WebElement>	findElementsByName(String name)
List<org.openqa.selenium.WebElement>	findElementsByPartialLinkText(String partialLinkText)
List<org.openqa.selenium.WebElement>	findElementsByTagName(String tagName)
List<org.openqa.selenium.WebElement>	findElementsByXPath(String path)
void	get(String s)
org.openqa.selenium.Capabilities	getCapabilities()
String	getCurrentUrl()
com.applitools.eyes.RectangleSize	getDefaultContentViewportSize() See getDefaultContentViewportSize(boolean).
com.applitools.eyes.RectangleSize	getDefaultContentViewportSize(boolean forceQuery)
protected double	getDevicePixelRatioInner()
Map<String,org.openqa.selenium.WebElement>	getElementIds() Found elements are sometimes accessed by their IDs (e.g.
SeleniumEyes	getEyes()
FrameChain	getFrameChain()
long	getInnerWidth()
org.openqa.selenium.interactions.Keyboard	getKeyboard()
org.openqa.selenium.interactions.Mouse	getMouse()
String	getPageSource()
org.openqa.selenium.remote.RemoteWebDriver	getRemoteWebDriver()
ImageRotation	getRotation()
<X> X	getScreenshotAs(org.openqa.selenium.OutputType<X> xOutputType)
String	getTitle()
org.openqa.selenium.interactions.TouchScreen	getTouch()
String	getUserAgent()
String	getWindowHandle()
Set<String>	getWindowHandles()
org.openqa.selenium.WebDriver.Options	manage()
org.openqa.selenium.WebDriver.Navigation	navigate()
static BufferedImage	normalizeRotation(com.applitools.eyes.Logger logger, org.openqa.selenium.WebDriver driver, BufferedImage image, ImageRotation rotation) Rotates the image as necessary.
void	quit()
void	setRotation(ImageRotation rotation)
org.openqa.selenium.WebDriver.TargetLocator	switchTo()

Methods inherited from class com.applitools.eyes.selenium.wrappers.EyesWebDriver

getDevicePixelRatio, getEyesBase, getTestId

Methods inherited from class java.lang.Object

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

Constructor Detail

EyesSeleniumDriver

public EyesSeleniumDriver(com.applitools.eyes.Logger logger,
                          SeleniumEyes eyes,
                          org.openqa.selenium.remote.RemoteWebDriver driver)
                   throws com.applitools.eyes.EyesException

Throws:

com.applitools.eyes.EyesException

Method Detail

normalizeRotation

public static BufferedImage normalizeRotation(com.applitools.eyes.Logger logger,
                                              org.openqa.selenium.WebDriver driver,
                                              BufferedImage image,
                                              ImageRotation rotation)

Rotates the image as necessary. The rotation is either manually forced by passing a non-null ImageRotation, or automatically inferred.

Parameters:

driver - The underlying driver which produced the screenshot.

image - The image to normalize.

rotation - The degrees by which to rotate the image: positive values = clockwise rotation, negative values = counter-clockwise, 0 = force no rotation, null = rotate automatically as needed.

logger - logger

Returns:

A normalized image.

getEyes

public SeleniumEyes getEyes()

getRemoteWebDriver

public org.openqa.selenium.remote.RemoteWebDriver getRemoteWebDriver()

Specified by:

getRemoteWebDriver in class EyesWebDriver

getTouch

public org.openqa.selenium.interactions.TouchScreen getTouch()

Specified by:

getTouch in interface org.openqa.selenium.interactions.HasTouchScreen

getRotation

public ImageRotation getRotation()

Returns:

The image rotation model.

setRotation

public void setRotation(ImageRotation rotation)

Parameters:

rotation - The image rotation model.

get

public void get(String s)

Specified by:

get in interface org.openqa.selenium.WebDriver

getCurrentUrl

public String getCurrentUrl()

Specified by:

getCurrentUrl in interface org.openqa.selenium.WebDriver

getTitle

public String getTitle()

Specified by:

getTitle in interface org.openqa.selenium.WebDriver

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.WebDriver

Specified by:

findElements in class EyesWebDriver

getDevicePixelRatioInner

protected double getDevicePixelRatioInner()

Specified by:

getDevicePixelRatioInner in class EyesWebDriver

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.WebDriver

Specified by:

findElement in class EyesWebDriver

getElementIds

public Map<String,org.openqa.selenium.WebElement> getElementIds()

Found elements are sometimes accessed by their IDs (e.g. tapping an element in Appium).

Returns:

Maps of IDs for found elements.

getPageSource

public String getPageSource()

Specified by:

getPageSource in interface org.openqa.selenium.WebDriver

close

public void close()

Specified by:

close in interface org.openqa.selenium.WebDriver

quit

public void quit()

Specified by:

quit in interface org.openqa.selenium.WebDriver

getWindowHandles

public Set<String> getWindowHandles()

Specified by:

getWindowHandles in interface org.openqa.selenium.WebDriver

getWindowHandle

public String getWindowHandle()

Specified by:

getWindowHandle in interface org.openqa.selenium.WebDriver

switchTo

public org.openqa.selenium.WebDriver.TargetLocator switchTo()

Specified by:

switchTo in interface org.openqa.selenium.WebDriver

navigate

public org.openqa.selenium.WebDriver.Navigation navigate()

Specified by:

navigate in interface org.openqa.selenium.WebDriver

manage

public org.openqa.selenium.WebDriver.Options manage()

Specified by:

manage in interface org.openqa.selenium.WebDriver

getMouse

public org.openqa.selenium.interactions.Mouse getMouse()

Specified by:

getMouse in interface org.openqa.selenium.interactions.HasInputDevices

getKeyboard

public org.openqa.selenium.interactions.Keyboard getKeyboard()

Specified by:

getKeyboard in interface org.openqa.selenium.interactions.HasInputDevices

findElementByClassName

public org.openqa.selenium.WebElement findElementByClassName(String className)

findElementsByClassName

public List<org.openqa.selenium.WebElement> findElementsByClassName(String className)

findElementByCssSelector

public org.openqa.selenium.WebElement findElementByCssSelector(String cssSelector)

findElementsByCssSelector

public List<org.openqa.selenium.WebElement> findElementsByCssSelector(String cssSelector)

findElementById

public org.openqa.selenium.WebElement findElementById(String id)

findElementsById

public List<org.openqa.selenium.WebElement> findElementsById(String id)

findElementByLinkText

public org.openqa.selenium.WebElement findElementByLinkText(String linkText)

findElementsByLinkText

public List<org.openqa.selenium.WebElement> findElementsByLinkText(String linkText)

findElementByPartialLinkText

public org.openqa.selenium.WebElement findElementByPartialLinkText(String partialLinkText)

findElementsByPartialLinkText

public List<org.openqa.selenium.WebElement> findElementsByPartialLinkText(String partialLinkText)

findElementByName

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

findElementsByName

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

findElementByTagName

public org.openqa.selenium.WebElement findElementByTagName(String tagName)

findElementsByTagName

public List<org.openqa.selenium.WebElement> findElementsByTagName(String tagName)

findElementByXPath

public org.openqa.selenium.WebElement findElementByXPath(String path)

findElementsByXPath

public List<org.openqa.selenium.WebElement> findElementsByXPath(String path)

getCapabilities

public org.openqa.selenium.Capabilities getCapabilities()

Specified by:

getCapabilities in interface org.openqa.selenium.HasCapabilities

executeScript

public Object executeScript(String script,
                            Object... args)

Specified by:

executeScript in interface com.applitools.eyes.IEyesJsExecutor

Specified by:

executeScript in interface org.openqa.selenium.JavascriptExecutor

executeAsyncScript

public Object executeAsyncScript(String script,
                                 Object... args)

Specified by:

executeAsyncScript in interface org.openqa.selenium.JavascriptExecutor

getDefaultContentViewportSize

public com.applitools.eyes.RectangleSize getDefaultContentViewportSize(boolean forceQuery)

Parameters:

forceQuery - If true, we will perform the query even if we have a cached viewport size.

Returns:

The viewport size of the default content (outer most frame).

getDefaultContentViewportSize

public com.applitools.eyes.RectangleSize getDefaultContentViewportSize()

See getDefaultContentViewportSize(boolean). forceQuery defaults to false.

Returns:

the DefaultContentViewportSize

getFrameChain

public FrameChain getFrameChain()

Returns:

The current frame chain.

getScreenshotAs

public <X> X getScreenshotAs(org.openqa.selenium.OutputType<X> xOutputType)
                      throws org.openqa.selenium.WebDriverException

Specified by:

getScreenshotAs in interface org.openqa.selenium.TakesScreenshot

Throws:

org.openqa.selenium.WebDriverException

getUserAgent

public String getUserAgent()

getInnerWidth

public long getInnerWidth()