eyes check element command

Platform: Selenium IDE

You can use the SIDE Eyeseyes check commands to execute checkpoints, that is, to capture a screenshot from the current browser window and to send it to Eyes for matching.

There are two variations of this command:
  • eyes check window: captures all the content in the browser or application window.
  • eyes check element: captures the image in a rectangular area defined by the element you define by a selector that you provide as a parameter.

When an eyes check command is used in a script, and that script is called from another script using Selenium IDE run command, the check command is ignored.

Use the eyes check element when you want to limit the visual test to the enclosing rectangle of an element. The rectangle includes any element padding and border, but not the margin.

You can enter this command in the Selenium IDE command field,

You can also add it interactively using the SIDE Eyes icon at the top of the browser during a test recording.

The command takes two parameters:

The first parameter defines the selected element. You can enter this parameter interactively by clicking on the select target button hovering over an element and clicking on the mouse. If you enter the command interactively using the menu then you are prompted to select the element. You can also enter the element selector in the Target text box, for example as follows:


The set of possible values that you can give as a selector are defined by Selenium IDE.

The second parameter is the tag. The tag defines a name for the checkpoint in the Eyes Test Manager. The name may be any string and serves to identify the step to the user in the Test manager. You may change the tag value without impacting testing in any way since Eyes does not use the tag to identify the baseline step that corresponds to the checkpoint - Eyes matches steps based on their content and position in the sequences of images of the test. See How Eyes compares checkpoints and baseline images for details. If you don't provide a tag, then the current URI is passed as the tag.