com.applitools.eyes.images

Class Eyes

java.lang.Object

com.applitools.eyes.EyesBase

com.applitools.eyes.images.Eyes

public class Eyes
extends EyesBase

Field Summary

Fields inherited from class com.applitools.eyes.EyesBase

cutProviderHandler, lastScreenshot, logger, positionProvider, runningSession, scaleProviderHandler, serverConnector, sessionStartInfo, USE_DEFAULT_TIMEOUT, viewportSize

Constructor Summary

Constructors

Constructor and Description
Eyes() Creates a new Eyes instance that interacts with the Eyes Server at the specified url.
Eyes(URI serverUrl) Creates a new (possibly disabled) Eyes instance that interacts with the Eyes Server at the specified url.

Method Summary

Modifier and Type	Method and Description
void	addMouseTrigger(MouseAction action, Region control, Location cursor)
void	addTextTrigger(Region control, String text)
boolean	checkImage(BufferedImage image)
boolean	checkImage(BufferedImage image, String tag)
boolean	checkImage(BufferedImage image, String tag, boolean ignoreMismatch) Matches the input image with the next expected image.
boolean	checkImage(byte[] image)
boolean	checkImage(byte[] image, String tag) See checkImage(byte[], String, boolean).
boolean	checkImage(byte[] image, String tag, boolean ignoreMismatch) Matches the input image with the next expected image.
boolean	checkImage(String path)
boolean	checkImage(String path, String tag) See checkImage(String, String, boolean).
boolean	checkImage(String path, String tag, boolean ignoreMismatch) Matches the image stored in the input file with the next expected image.
void	checkRegion(BufferedImage image, Region region)
void	checkRegion(BufferedImage image, Region region, String tag)
boolean	checkRegion(BufferedImage image, Region region, String tag, boolean ignoreMismatch) Perform visual validation for the current image.
boolean	checkWindow(BufferedImage image) Deprecated.
boolean	checkWindow(BufferedImage image, String tag) Deprecated.
boolean	checkWindow(BufferedImage image, String tag, boolean ignoreMismatch) Deprecated.
String	getBaseAgentId()
protected String	getInferredEnvironment()
EyesScreenshot	getScreenshot()
protected String	getTitle()
RectangleSize	getViewportSize()
void	open(String appName, String testName)
void	open(String appName, String testName, RectangleSize dimensions) Starts a test.
void	setInferredEnvironment(String inferred)
void	setViewportSize(RectangleSize size)

Methods inherited from class com.applitools.eyes.EyesBase

abortIfNotClosed, addMouseTriggerBase, addTextTriggerBase, addUserInput, checkWindowBase, checkWindowBase, clearUserInputs, close, close, closeResponseTime, getAgentId, getApiKey, getAppEnvironment, getAppName, getBaselineEnvName, getBaselineName, getBatch, getBranchName, getDefaultMatchSettings, getDefaultServerUrl, getEnvName, getFailureReports, getFullAgentId, getHostApp, getHostOS, getIsDisabled, getIsOpen, getLogHandler, getMatchLevel, getMatchTimeout, getParentBranchName, getPositionProvider, getProxy, getSaveFailedTests, getSaveNewTests, getScaleMethod, getScaleRatio, getServerUrl, getUserInputs, openBase, setAgentId, setApiKey, setAppEnvironment, setAppName, setBaselineEnvName, setBaselineName, setBatch, setBranchName, setDefaultMatchSettings, setEnvName, setFailureReports, setHostApp, setHostOS, setImageCut, setIsDisabled, setLogHandler, setMatchLevel, setMatchTimeout, setParentBranchName, setPositionProvider, setProxy, setSaveFailedTests, setSaveNewTests, setScaleMethod, setScaleRatio, setServerUrl, startSession, testResponseTimeBase

Methods inherited from class java.lang.Object

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

Constructor Detail

Eyes

public Eyes(URI serverUrl)

Creates a new (possibly disabled) Eyes instance that interacts with the Eyes Server at the specified url.

Parameters:

serverUrl - The Eyes server URL.

Eyes

public Eyes()

Creates a new Eyes instance that interacts with the Eyes Server at the specified url.

Method Detail

getBaseAgentId

public String getBaseAgentId()

Specified by:

getBaseAgentId in class EyesBase

open

public void open(String appName,
                 String testName,
                 RectangleSize dimensions)

Starts a test.

Parameters:

appName - The name of the application under test.

testName - The test name.

dimensions - Determines the resolution used for the baseline. null will automatically grab the resolution from the image.

open

public void open(String appName,
                 String testName)

checkWindow

@Deprecated
public boolean checkWindow(BufferedImage image)

Deprecated.

checkWindow

@Deprecated
public boolean checkWindow(BufferedImage image,
                                       String tag)

Deprecated.

checkWindow

@Deprecated
public boolean checkWindow(BufferedImage image,
                                       String tag,
                                       boolean ignoreMismatch)

Deprecated.

checkImage

public boolean checkImage(BufferedImage image)

checkImage

public boolean checkImage(BufferedImage image,
                          String tag)

checkImage

public boolean checkImage(BufferedImage image,
                          String tag,
                          boolean ignoreMismatch)

Matches the input image with the next expected image.

Parameters:

image - The image to perform visual validation for.

tag - An optional tag to be associated with the validation checkpoint.

ignoreMismatch - True if the server should ignore a negative result for the visual validation.

Returns:

True if the image matched the expected output, false otherwise.

Throws:

TestFailedException - Thrown if a mismatch is detected and immediate failure reports are enabled.

checkImage

public boolean checkImage(String path)

checkImage

public boolean checkImage(String path,
                          String tag)

See checkImage(String, String, boolean). ignoreMismatch defaults to false.

Parameters:

path - The path to the image to check.

tag - The tag to be associated with the visual checkpoint.

Returns:

Whether or not the image matched the baseline.

checkImage

public boolean checkImage(String path,
                          String tag,
                          boolean ignoreMismatch)

Matches the image stored in the input file with the next expected image. See checkImage(BufferedImage, String, boolean).

Parameters:

path - The base64 representation of the image's raw bytes.

tag - An optional tag to be associated with the validation checkpoint.

ignoreMismatch - True if the server should ignore a negative result for the visual validation.

Returns:

Whether or not the image matched the baseline.

checkImage

public boolean checkImage(byte[] image)

checkImage

public boolean checkImage(byte[] image,
                          String tag)

See checkImage(byte[], String, boolean). ignoreMismatch defaults to false.

Parameters:

image - The raw png bytes of the image to perform visual validation for.

tag - An optional tag to be associated with the validation checkpoint.

Returns:

Whether or not the image matched the baseline.

checkImage

public boolean checkImage(byte[] image,
                          String tag,
                          boolean ignoreMismatch)

Matches the input image with the next expected image. See checkImage(BufferedImage, String, boolean).

Parameters:

image - The raw png bytes of the image to perform visual validation for.

tag - An optional tag to be associated with the validation checkpoint.

ignoreMismatch - True if the server should ignore a negative result for the visual validation.

Returns:

Whether or not the image matched the baseline.

checkRegion

public boolean checkRegion(BufferedImage image,
                           Region region,
                           String tag,
                           boolean ignoreMismatch)

Perform visual validation for the current image.

Parameters:

image - The image to perform visual validation for.

region - The region to validate within the image.

tag - An optional tag to be associated with the validation checkpoint.

ignoreMismatch - True if the server should ignore a negative result for the visual validation.

Returns:

Whether or not the image matched the baseline.

Throws:

TestFailedException - Thrown if a mismatch is detected and immediate failure reports are enabled.

checkRegion

public void checkRegion(BufferedImage image,
                        Region region,
                        String tag)

checkRegion

public void checkRegion(BufferedImage image,
                        Region region)

addMouseTrigger

public void addMouseTrigger(MouseAction action,
                            Region control,
                            Location cursor)

addTextTrigger

public void addTextTrigger(Region control,
                           String text)

getViewportSize

public RectangleSize getViewportSize()

Specified by:

getViewportSize in class EyesBase

setViewportSize

public void setViewportSize(RectangleSize size)

Specified by:

setViewportSize in class EyesBase

getInferredEnvironment

protected String getInferredEnvironment()

Specified by:

getInferredEnvironment in class EyesBase

setInferredEnvironment

public void setInferredEnvironment(String inferred)

getScreenshot

public EyesScreenshot getScreenshot()

Specified by:

getScreenshot in class EyesBase

getTitle

protected String getTitle()

Specified by:

getTitle in class EyesBase