com.applitools.utils

Class EyesSeleniumUtils

java.lang.Object

com.applitools.utils.EyesSeleniumUtils

public class EyesSeleniumUtils
extends Object

We named this class EyesSeleniumUtils because there's a SeleniumUtils class, and it caused collision.

Constructor Summary

Constructors

Constructor and Description
EyesSeleniumUtils()

Method Summary

Modifier and Type	Method and Description
static com.applitools.eyes.RectangleSize	executeViewportSizeExtraction(org.openqa.selenium.JavascriptExecutor executor)
static com.applitools.eyes.RectangleSize	extractViewportSize(com.applitools.eyes.Logger logger, org.openqa.selenium.WebDriver driver)
static com.applitools.eyes.RectangleSize	getCurrentFrameContentEntireSize(org.openqa.selenium.JavascriptExecutor executor)
static com.applitools.eyes.Location	getCurrentScrollPosition(org.openqa.selenium.JavascriptExecutor executor)
static String	getCurrentTransform(org.openqa.selenium.JavascriptExecutor executor)
static float	getDevicePixelRatio(org.openqa.selenium.JavascriptExecutor executor)
static com.applitools.eyes.Location	getPageLocation(org.openqa.selenium.interactions.internal.Coordinates coordinates) Extracts the location relative to the entire page from the coordinates (e.g.
static String	getPlatformVersion(org.openqa.selenium.HasCapabilities driver)
static com.applitools.eyes.Location	getViewportLocation(org.openqa.selenium.interactions.internal.Coordinates coordinates) Extracts the location relative to the viewport from the coordinates (e.g.
static String	hideScrollbars(org.openqa.selenium.JavascriptExecutor executor, int stabilizationTimeout) Hides the scrollbars of the current context's document element.
static boolean	isAndroid(org.openqa.selenium.WebDriver driver)
static boolean	isIOS(org.openqa.selenium.WebDriver driver)
static boolean	isLandscapeOrientation(org.openqa.selenium.WebDriver driver)
static boolean	isMobileDevice(org.openqa.selenium.WebDriver driver)
static void	setCurrentScrollPosition(org.openqa.selenium.JavascriptExecutor executor, com.applitools.eyes.Location location) Sets the scroll position of the current frame.
static String	setOverflow(org.openqa.selenium.JavascriptExecutor executor, String value) Sets the overflow of the current context's document element.
static String	setTransform(org.openqa.selenium.JavascriptExecutor executor, String transform)
static void	setViewportSize(com.applitools.eyes.Logger logger, org.openqa.selenium.WebDriver driver, com.applitools.eyes.RectangleSize size)
static String	translateTo(org.openqa.selenium.JavascriptExecutor executor, com.applitools.eyes.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

EyesSeleniumUtils

public EyesSeleniumUtils()

Method Detail

getPageLocation

public static com.applitools.eyes.Location getPageLocation(org.openqa.selenium.interactions.internal.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 com.applitools.eyes.Location getViewportLocation(org.openqa.selenium.interactions.internal.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.

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.

isLandscapeOrientation

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

Parameters:

driver - The driver for which to check the orientation.

Returns:

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

setOverflow

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

Sets the overflow of the current context's document element.

Parameters:

executor - The executor to use for setting the overflow.

value - The overflow value to set.

Returns:

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

hideScrollbars

public static String hideScrollbars(org.openqa.selenium.JavascriptExecutor executor,
                                    int stabilizationTimeout)

Hides the scrollbars of the current context's document element.

Parameters:

executor - The executor to use for hiding the scrollbars.

stabilizationTimeout - The amount of time to wait for the "hide scrollbars" action to take effect (Milliseconds). Zero/negative values are ignored.

Returns:

The previous value of the overflow property (could be null).

getCurrentScrollPosition

public static com.applitools.eyes.Location getCurrentScrollPosition(org.openqa.selenium.JavascriptExecutor executor)

Parameters:

executor - The executor to use.

Returns:

The current scroll position of the current frame.

setCurrentScrollPosition

public static void setCurrentScrollPosition(org.openqa.selenium.JavascriptExecutor executor,
                                            com.applitools.eyes.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 com.applitools.eyes.RectangleSize getCurrentFrameContentEntireSize(org.openqa.selenium.JavascriptExecutor executor)

Parameters:

executor - The executor to use.

Returns:

The size of the entire content.

executeViewportSizeExtraction

public static com.applitools.eyes.RectangleSize executeViewportSizeExtraction(org.openqa.selenium.JavascriptExecutor executor)

Parameters:

executor - The executor to use.

Returns:

The viewport size.

extractViewportSize

public static com.applitools.eyes.RectangleSize extractViewportSize(com.applitools.eyes.Logger logger,
                                                                    org.openqa.selenium.WebDriver driver)

Parameters:

logger - The logger to use.

driver - The web driver to use.

Returns:

The viewport size of the current context.

setViewportSize

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

Parameters:

logger - The logger to use.

driver - The web driver to use.

size - The size to set as the viepwort size.

isAndroid

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

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)

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 plaform version or null if it is undefined.

getDevicePixelRatio

public static float getDevicePixelRatio(org.openqa.selenium.JavascriptExecutor executor)

Parameters:

executor - The executor to use.

Returns:

The device pixel ratio.

getCurrentTransform

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

Parameters:

executor - The executor to use.

Returns:

The current documentElement transform value.

setTransform

public static String setTransform(org.openqa.selenium.JavascriptExecutor executor,
                                  String transform)

Parameters:

executor - The executor to use.

transform - The transform to set.

Returns:

The previous documentElement transform value.

translateTo

public static String translateTo(org.openqa.selenium.JavascriptExecutor executor,
                                 com.applitools.eyes.Location position)

Translates the current documentElement to the given position.

Parameters:

executor - The executor to use.

position - The position to translate to.

Returns:

The previous transform of the documentElement.