com.applitools.eyes.selenium

Class EyesDriverUtils

java.lang.Object

com.applitools.eyes.selenium.EyesDriverUtils

public class EyesDriverUtils
extends Object

Constructor Summary

Constructors

Constructor and Description
EyesDriverUtils()

Method Summary

Modifier and Type	Method and Description
static RectangleSize	getCurrentFrameContentEntireSize(IEyesJsExecutor executor) Gets current frame content entire size.
static Location	getCurrentScrollPosition(IEyesJsExecutor executor) Gets current scroll position.
static Map<String,String>	getCurrentTransform(IEyesJsExecutor executor) Gets current transform.
static RectangleSize	getElementVisibleSize(Logger logger, org.openqa.selenium.WebElement element) Returns given element visible portion size.\
static RectangleSize	getEntireElementSize(Logger logger, IEyesJsExecutor executor, org.openqa.selenium.WebElement element) Gets entire element size.
static String	getMobileDeviceName(org.openqa.selenium.HasCapabilities driver)
static Location	getPageLocation(org.openqa.selenium.interactions.Coordinates coordinates) Extracts the location relative to the entire page from the coordinates (e.g.
static String	getPlatformVersion(org.openqa.selenium.HasCapabilities driver)
static org.openqa.selenium.WebDriver	getUnderlyingDriver(org.openqa.selenium.WebDriver driver) For EyesWebDriver instances, returns the underlying WebDriver.
static Location	getViewportLocation(org.openqa.selenium.interactions.Coordinates coordinates) Extracts the location relative to the viewport from the coordinates (e.g.
static RectangleSize	getViewportSize(org.openqa.selenium.JavascriptExecutor executor) Gets viewport size.
static RectangleSize	getViewportSizeOrDisplaySize(Logger logger, org.openqa.selenium.WebDriver driver) Gets viewport size or display size.
static org.openqa.selenium.Rectangle	getVisibleElementRect(org.openqa.selenium.WebElement webElement, EyesWebDriver driver)
static org.openqa.selenium.WebElement	getWrappedWebElement(org.openqa.selenium.WebElement webElement) If the web element was created by FindBy, then it's a Proxy object.
static boolean	isAndroid(org.openqa.selenium.WebDriver driver) Is android boolean.
static boolean	isIOS(org.openqa.selenium.WebDriver driver) Is ios boolean.
static boolean	isLandscapeOrientation(Logger logger, org.openqa.selenium.WebDriver driver) Is landscape orientation boolean.
static boolean	isMobileDevice(org.openqa.selenium.WebDriver driver)
static boolean	isMobileDeviceByContext(org.openqa.selenium.WebDriver driver)
static Location	parseLocationString(Object position)
static String	selectRootElement(org.openqa.selenium.JavascriptExecutor executor) Select root element string.
static boolean	setBrowserSize(org.openqa.selenium.WebDriver driver, RectangleSize requiredSize) Sets browser size.
static boolean	setBrowserSizeByViewportSize(org.openqa.selenium.WebDriver driver, RectangleSize actualViewportSize, RectangleSize requiredViewportSize) Sets browser size by viewport size.
static void	setCurrentScrollPosition(IEyesJsExecutor executor, Location location) Sets the scroll position of the current frame.
static String	setOverflow(org.openqa.selenium.JavascriptExecutor executor, String value, org.openqa.selenium.WebElement rootElement) Sets the overflow of the current context's body.
static void	setTransform(IEyesJsExecutor executor, String transform) Set the given transform to document.documentElement for all style keys defined in JS_TRANSFORM_KEYS .
static void	setTransforms(IEyesJsExecutor executor, Map<String,String> transforms) Sets transforms for document.documentElement according to the given map of style keys and values.
static void	setViewportSize(Logger logger, org.openqa.selenium.WebDriver driver, RectangleSize size) Sets viewport size.
static void	translateTo(IEyesJsExecutor executor, Location position) Translates the current documentElement to the given position.

Methods inherited from class java.lang.Object

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

Constructor Detail

EyesDriverUtils

public EyesDriverUtils()

Method Detail

getPageLocation

public static Location getPageLocation(org.openqa.selenium.interactions.Coordinates coordinates)

Extracts the location relative to the entire page from the coordinates (e.g. as opposed to viewport)

Parameters:

coordinates - The coordinates from which location is extracted.

Returns:

The location relative to the entire page

getViewportLocation

public static Location getViewportLocation(org.openqa.selenium.interactions.Coordinates coordinates)

Extracts the location relative to the viewport from the coordinates (e.g. as opposed to the entire page).

Parameters:

coordinates - The coordinates from which location is extracted.

Returns:

The location relative to the viewport.

getUnderlyingDriver

public static org.openqa.selenium.WebDriver getUnderlyingDriver(org.openqa.selenium.WebDriver driver)

For EyesWebDriver instances, returns the underlying WebDriver. For all other types - return the driver received as parameter.

Parameters:

driver - The driver instance for which to get the underlying WebDriver.

Returns:

The underlying WebDriver

isMobileDevice

public static boolean isMobileDevice(org.openqa.selenium.WebDriver driver)

Parameters:

driver - The driver for which to check if it represents a mobile device.

Returns:

true if the platform running the test is a mobile platform. false otherwise.

isMobileDeviceByContext

public static boolean isMobileDeviceByContext(org.openqa.selenium.WebDriver driver)

isLandscapeOrientation

public static boolean isLandscapeOrientation(Logger logger,
                                             org.openqa.selenium.WebDriver driver)

Is landscape orientation boolean.

Parameters:

logger - the logger

driver - The driver for which to check the orientation.

Returns:

true if this is a mobile device and is in landscape orientation. false otherwise.

selectRootElement

public static String selectRootElement(org.openqa.selenium.JavascriptExecutor executor)

Select root element string.

Parameters:

executor - the executor

Returns:

the string

setOverflow

public static String setOverflow(org.openqa.selenium.JavascriptExecutor executor,
                                 String value,
                                 org.openqa.selenium.WebElement rootElement)

Sets the overflow of the current context's body.

Parameters:

executor - The executor to use for setting the overflow.

value - The overflow value to set.

rootElement - the root element

Returns:

The previous overflow value (could be null if undefined).

getCurrentScrollPosition

public static Location getCurrentScrollPosition(IEyesJsExecutor executor)

Gets current scroll position.

Parameters:

executor - The executor to use.

Returns:

The current scroll position of the current frame.

parseLocationString

public static Location parseLocationString(Object position)

setCurrentScrollPosition

public static void setCurrentScrollPosition(IEyesJsExecutor executor,
                                            Location location)

Sets the scroll position of the current frame.

Parameters:

executor - The executor to use.

location - The position to be set.

getCurrentFrameContentEntireSize

public static RectangleSize getCurrentFrameContentEntireSize(IEyesJsExecutor executor)

Gets current frame content entire size.

Parameters:

executor - The executor to use.

Returns:

The size of the entire content.

getEntireElementSize

public static RectangleSize getEntireElementSize(Logger logger,
                                                 IEyesJsExecutor executor,
                                                 org.openqa.selenium.WebElement element)

Gets entire element size.

Parameters:

logger - the logger

executor - the executor

element - the element

Returns:

the entire element size

getViewportSize

public static RectangleSize getViewportSize(org.openqa.selenium.JavascriptExecutor executor)

Gets viewport size.

Parameters:

executor - The executor to use.

Returns:

The viewport size.

getViewportSizeOrDisplaySize

public static RectangleSize getViewportSizeOrDisplaySize(Logger logger,
                                                         org.openqa.selenium.WebDriver driver)

Gets viewport size or display size.

Parameters:

logger - The logger to use.

driver - The web driver to use.

Returns:

The viewport size of the current context, or the display size if the viewport size cannot be retrieved.

setBrowserSize

public static boolean setBrowserSize(org.openqa.selenium.WebDriver driver,
                                     RectangleSize requiredSize)

Sets browser size.

Parameters:

driver - the driver

requiredSize - the required size

Returns:

the browser size

setBrowserSizeByViewportSize

public static boolean setBrowserSizeByViewportSize(org.openqa.selenium.WebDriver driver,
                                                   RectangleSize actualViewportSize,
                                                   RectangleSize requiredViewportSize)

Sets browser size by viewport size.

Parameters:

driver - the driver

actualViewportSize - the actual viewport size

requiredViewportSize - the required viewport size

Returns:

the browser size by viewport size

setViewportSize

public static void setViewportSize(Logger logger,
                                   org.openqa.selenium.WebDriver driver,
                                   RectangleSize size)

Sets viewport size.

Parameters:

logger - The logger to use.

driver - The web driver to use.

size - The size to set as the viewport size.

isAndroid

public static boolean isAndroid(org.openqa.selenium.WebDriver driver)

Is android boolean.

Parameters:

driver - The driver to test.

Returns:

true if the driver is an Android driver. false otherwise.

isIOS

public static boolean isIOS(org.openqa.selenium.WebDriver driver)

Is ios boolean.

Parameters:

driver - The driver to test.

Returns:

true if the driver is an iOS driver. false otherwise.

getPlatformVersion

public static String getPlatformVersion(org.openqa.selenium.HasCapabilities driver)

Parameters:

driver - The driver to get the platform version from.

Returns:

The platform version or null if it is undefined.

getMobileDeviceName

public static String getMobileDeviceName(org.openqa.selenium.HasCapabilities driver)

Parameters:

driver - The driver to get the platform version from.

Returns:

The device name or 'Unknown' if it is undefined.

getCurrentTransform

public static Map<String,String> getCurrentTransform(IEyesJsExecutor executor)

Gets current transform.

Parameters:

executor - The executor to use.

Returns:

The current documentElement transform values, according to JS_TRANSFORM_KEYS.

setTransforms

public static void setTransforms(IEyesJsExecutor executor,
                                 Map<String,String> transforms)

Sets transforms for document.documentElement according to the given map of style keys and values.

Parameters:

executor - The executor to use.

transforms - The transforms to set. Keys are used as style keys, and values are the values for those styles.

setTransform

public static void setTransform(IEyesJsExecutor executor,
                                String transform)

Set the given transform to document.documentElement for all style keys defined in JS_TRANSFORM_KEYS .

Parameters:

executor - The executor to use.

transform - The transform value to set.

getElementVisibleSize

public static RectangleSize getElementVisibleSize(Logger logger,
                                                  org.openqa.selenium.WebElement element)

Returns given element visible portion size.\

Parameters:

element - The element for which to return the size.

Returns:

The given element's visible portion size.

translateTo

public static void translateTo(IEyesJsExecutor executor,
                               Location position)

Translates the current documentElement to the given position.

Parameters:

executor - The executor to use.

position - The position to translate to.

getWrappedWebElement

public static org.openqa.selenium.WebElement getWrappedWebElement(org.openqa.selenium.WebElement webElement)

If the web element was created by FindBy, then it's a Proxy object. This method gets the real web element from the proxy object.

getVisibleElementRect

public static org.openqa.selenium.Rectangle getVisibleElementRect(org.openqa.selenium.WebElement webElement,
                                                                  EyesWebDriver driver)