Skip to main content

Element Validations

You can perform assertions and verifications on web elements using the WebDriverElementValidationsBuilder. Access it through the driver instance or the standalone Validations class.

exists()​

Checks that the target element exists in the DOM.

ElementExistsValidation.java
// Using driver-based validation (recommended)
driver.assertThat().element(locator).exists().perform();
driver.verifyThat().element(locator).exists().perform();

// Using standalone validation
Validations.assertThat().element(driver.getDriver(), locator).exists().perform();
Validations.verifyThat().element(driver.getDriver(), locator).exists().perform();

doesNotExist()​

Checks that the target element does not exist in the DOM.

ElementDoesNotExistValidation.java
driver.assertThat().element(locator).doesNotExist().perform();
driver.verifyThat().element(locator).doesNotExist().perform();

matchesReferenceImage()​

Checks that the target element matches a reference image using OpenCV. On the first run, a screenshot of the element is captured and saved as the reference. Subsequent runs compare the element against this reference. Reference images are stored under src/test/resources/DynamicObjectRepository.

VisualValidation.java
driver.assertThat().element(locator).matchesReferenceImage().perform();
driver.verifyThat().element(locator).matchesReferenceImage().perform();

doesNotMatchReferenceImage()​

Checks that the target element does not match the stored reference image.

VisualMismatchValidation.java
driver.assertThat().element(locator).doesNotMatchReferenceImage().perform();
driver.verifyThat().element(locator).doesNotMatchReferenceImage().perform();

attribute()​

Checks a specific element attribute against an expected value. After calling .attribute(), chain a comparison method such as .isEqualTo(), .contains(), .doesNotContain(), .matchesRegex(), and more.

ElementAttributeValidation.java
// Validate the "class" attribute contains "active"
driver.assertThat().element(locator).attribute("class").contains("active").perform();

// Validate the "href" attribute equals a specific URL
driver.verifyThat().element(locator).attribute("href").isEqualTo("https://example.com").perform();

text()​

Checks the text content of the target element. Chain a comparison method after calling .text().

ElementTextValidation.java
driver.assertThat().element(locator).text().isEqualTo("Welcome").perform();
driver.verifyThat().element(locator).text().contains("Welcome").perform();

textTrimmed()​

Checks the text content of the target element after trimming all leading and trailing whitespace.

ElementTextTrimmedValidation.java
driver.assertThat().element(locator).textTrimmed().isEqualTo("Hello World").perform();
driver.verifyThat().element(locator).textTrimmed().contains("Hello").perform();

cssProperty()​

Checks a CSS property value of the target element. Chain a comparison method after calling .cssProperty().

ElementCssValidation.java
driver.assertThat().element(locator).cssProperty("color").contains("rgb(0, 128, 0)").perform();
driver.verifyThat().element(locator).cssProperty("font-size").isEqualTo("14px").perform();

State Validations​

isVisible()​

Checks that the target element is visible on the page.

ElementVisibleValidation.java
driver.assertThat().element(locator).isVisible().perform();

isHidden()​

Checks that the target element is hidden.

ElementHiddenValidation.java
driver.assertThat().element(locator).isHidden().perform();

isEnabled()​

Checks that the target element is enabled (not disabled).

ElementEnabledValidation.java
driver.assertThat().element(locator).isEnabled().perform();

isDisabled()​

Checks that the target element is disabled.

ElementDisabledValidation.java
driver.assertThat().element(locator).isDisabled().perform();

isSelected()​

Checks that the target element is selected (e.g., a checkbox or radio button).

ElementSelectedValidation.java
driver.assertThat().element(locator).isSelected().perform();

isNotSelected()​

Checks that the target element is not selected.

ElementNotSelectedValidation.java
driver.assertThat().element(locator).isNotSelected().perform();

isChecked()​

Checks that the target element is checked.

ElementCheckedValidation.java
driver.assertThat().element(locator).isChecked().perform();

isNotChecked()​

Checks that the target element is not checked.

ElementNotCheckedValidation.java
driver.assertThat().element(locator).isNotChecked().perform();
tip

All the state validation methods above return a ValidationsExecutor. You can optionally add a custom report message before calling .perform():

driver.assertThat().element(locator).isVisible()
    .withCustomReportMessage("Verify login button is visible")
    .perform();