Class WebAssert

java.lang.Object
org.htmlunit.WebAssert
public final class WebAssert extends Object
Utility class which contains standard assertions for HTML pages.

  • Constructor Details

    • WebAssert

      private WebAssert()
      Private to prevent instantiation.

  • Method Details

    • assertTitleEquals

      public static void assertTitleEquals(HtmlPage page, String title)
      Verifies that the specified page's title equals the specified expected title.
      Parameters:
      page - the page to check
      title - the expected title

    • assertTitleContains

      public static void assertTitleContains(HtmlPage page, String titlePortion)
      Verifies that the specified page's title contains the specified substring.
      Parameters:
      page - the page to check
      titlePortion - the substring which the page title is expected to contain

    • assertTitleMatches

      public static void assertTitleMatches(HtmlPage page, String regex)
      Verifies that the specified page's title matches the specified regular expression.
      Parameters:
      page - the page to check
      regex - the regular expression that the page title is expected to match

    • assertElementPresent

      public static void assertElementPresent(HtmlPage page, String id)
      Verifies that the specified page contains an element with the specified ID.
      Parameters:
      page - the page to check
      id - the expected ID of an element in the page

    • assertElementPresentByXPath

      public static void assertElementPresentByXPath(HtmlPage page, String xpath)
      Verifies that the specified page contains an element matching the specified XPath expression.
      Parameters:
      page - the page to check
      xpath - the XPath expression which is expected to match an element in the page

    • assertElementNotPresent

      public static void assertElementNotPresent(HtmlPage page, String id)
      Verifies that the specified page does not contain an element with the specified ID.
      Parameters:
      page - the page to check
      id - the ID of an element which expected to not exist on the page

    • assertElementNotPresentByXPath

      public static void assertElementNotPresentByXPath(HtmlPage page, String xpath)
      Verifies that the specified page does not contain an element matching the specified XPath expression.
      Parameters:
      page - the page to check
      xpath - the XPath expression which is expected to not match an element in the page

    • assertTextPresent

      public static void assertTextPresent(HtmlPage page, String text)
      Verifies that the specified page contains the specified text.
      Parameters:
      page - the page to check
      text - the text to check for

    • assertTextPresentInElement

      public static void assertTextPresentInElement(HtmlPage page, String text, String id)
      Verifies that the element on the specified page which matches the specified ID contains the specified text.
      Parameters:
      page - the page to check
      text - the text to check for
      id - the ID of the element which is expected to contain the specified text

    • assertTextNotPresent

      public static void assertTextNotPresent(HtmlPage page, String text)
      Verifies that the specified page does not contain the specified text.
      Parameters:
      page - the page to check
      text - the text to check for

    • assertTextNotPresentInElement

      public static void assertTextNotPresentInElement(HtmlPage page, String text, String id)
      Verifies that the element on the specified page which matches the specified ID does not contain the specified text.
      Parameters:
      page - the page to check
      text - the text to check for
      id - the ID of the element which is expected to not contain the specified text

    • assertLinkPresent

      public static void assertLinkPresent(HtmlPage page, String id)
      Verifies that the specified page contains a link with the specified ID.
      Parameters:
      page - the page to check
      id - the ID of the link which the page is expected to contain

    • assertLinkNotPresent

      public static void assertLinkNotPresent(HtmlPage page, String id)
      Verifies that the specified page does not contain a link with the specified ID.
      Parameters:
      page - the page to check
      id - the ID of the link which the page is expected to not contain

    • assertLinkPresentWithText

      public static void assertLinkPresentWithText(HtmlPage page, String text)
      Verifies that the specified page contains a link with the specified text. The specified text may be a substring of the entire text contained by the link.
      Parameters:
      page - the page to check
      text - the text which a link in the specified page is expected to contain

    • assertLinkNotPresentWithText

      public static void assertLinkNotPresentWithText(HtmlPage page, String text)
      Verifies that the specified page does not contain a link with the specified text. The specified text may be a substring of the entire text contained by the link.
      Parameters:
      page - the page to check
      text - the text which a link in the specified page is not expected to contain

    • assertFormPresent

      public static void assertFormPresent(HtmlPage page, String name)
      Verifies that the specified page contains a form with the specified name.
      Parameters:
      page - the page to check
      name - the expected name of a form on the page

    • assertFormNotPresent

      public static void assertFormNotPresent(HtmlPage page, String name)
      Verifies that the specified page does not contain a form with the specified name.
      Parameters:
      page - the page to check
      name - the name of a form which should not exist on the page

    • assertInputPresent

      public static void assertInputPresent(HtmlPage page, String name)
      Verifies that the specified page contains an input element with the specified name.
      Parameters:
      page - the page to check
      name - the name of the input element to look for

    • assertInputNotPresent

      public static void assertInputNotPresent(HtmlPage page, String name)
      Verifies that the specified page does not contain an input element with the specified name.
      Parameters:
      page - the page to check
      name - the name of the input element to look for

    • assertInputContainsValue

      public static void assertInputContainsValue(HtmlPage page, String name, String value)
      Verifies that the input element with the specified name on the specified page contains the specified value.
      Parameters:
      page - the page to check
      name - the name of the input element to check
      value - the value to check for

    • assertInputDoesNotContainValue

      public static void assertInputDoesNotContainValue(HtmlPage page, String name, String value)
      Verifies that the input element with the specified name on the specified page does not contain the specified value.
      Parameters:
      page - the page to check
      name - the name of the input element to check
      value - the value to check for

    • assertAllTabIndexAttributesSet

      public static void assertAllTabIndexAttributesSet(HtmlPage page)

      Many HTML elements are "tabbable" and can have a tabindex attribute that determines the order in which the components are navigated when pressing the tab key. To ensure good usability for keyboard navigation, all tabbable elements should have the tabindex attribute set.

      This method verifies that all tabbable elements have a valid value set for the tabindex attribute.

      Parameters:
      page - the page to check

    • assertAllAccessKeyAttributesUnique

      public static void assertAllAccessKeyAttributesUnique(HtmlPage page)
      Many HTML components can have an accesskey attribute which defines a hot key for keyboard navigation. This method verifies that all the accesskey attributes on the specified page are unique.
      Parameters:
      page - the page to check

    • assertAllIdAttributesUnique

      public static void assertAllIdAttributesUnique(HtmlPage page)
      Verifies that all element IDs in the specified page are unique.
      Parameters:
      page - the page to check

    • notNull

      public static void notNull(String description, Object object)
      Assert that the specified parameter is not null. Throw a NullPointerException if a null is found.
      Parameters:
      description - the description to pass into the NullPointerException
      object - the object to check for null