org.openqa.selenium.support.ui

Class ExpectedConditions



  • public class ExpectedConditionsextends Object
    Canned ExpectedConditions which are generally useful within webdriver tests.
    • Method Detail

      • titleIs

        public static ExpectedCondition<Boolean> titleIs(String title)
        An expectation for checking the title of a page.
        Parameters:
        title - the expected title, which must be an exact match
        Returns:
        true when the title matches, false otherwise
      • titleContains

        public static ExpectedCondition<Boolean> titleContains(String title)
        An expectation for checking that the title contains a case-sensitive substring
        Parameters:
        title - the fragment of title expected
        Returns:
        true when the title matches, false otherwise
      • urlToBe

        public static ExpectedCondition<Boolean> urlToBe(String url)
        An expectation for the URL of the current page to be a specific url.
        Parameters:
        url - the url that the page should be on
        Returns:
        true when the URL is what it should be
      • urlContains

        public static ExpectedCondition<Boolean> urlContains(String fraction)
        An expectation for the URL of the current page to contain specific text.
        Parameters:
        fraction - the fraction of the url that the page should be on
        Returns:
        true when the URL contains the text
      • urlMatches

        public static ExpectedCondition<Boolean> urlMatches(String regex)
        Expectation for the URL to match a specific regular expression
        Parameters:
        regex - the regular expression that the URL should match
        Returns:
        true if the URL matches the specified regular expression
      • presenceOfElementLocated

        public static ExpectedCondition<org.openqa.selenium.WebElement> presenceOfElementLocated(org.openqa.selenium.By locator)
        An expectation for checking that an element is present on the DOM of a page. This does not necessarily mean that the element is visible.
        Parameters:
        locator - used to find the element
        Returns:
        the WebElement once it is located
      • visibilityOfElementLocated

        public static ExpectedCondition<org.openqa.selenium.WebElement> visibilityOfElementLocated(org.openqa.selenium.By locator)
        An expectation for checking that an element is present on the DOM of a page and visible. Visibility means that the element is not only displayed but also has a height and width that is greater than 0.
        Parameters:
        locator - used to find the element
        Returns:
        the WebElement once it is located and visible
      • visibilityOfAllElementsLocatedBy

        public static ExpectedCondition<List<org.openqa.selenium.WebElement>> visibilityOfAllElementsLocatedBy(org.openqa.selenium.By locator)
        An expectation for checking that all elements present on the web page that match the locator are visible. Visibility means that the elements are not only displayed but also have a height and width that is greater than 0.
        Parameters:
        locator - used to find the element
        Returns:
        the list of WebElements once they are located
      • visibilityOfAllElements

        public static ExpectedCondition<List<org.openqa.selenium.WebElement>> visibilityOfAllElements(List<org.openqa.selenium.WebElement> elements)
        An expectation for checking that all elements present on the web page that match the locator are visible. Visibility means that the elements are not only displayed but also have a height and width that is greater than 0.
        Parameters:
        elements - list of WebElements
        Returns:
        the list of WebElements once they are located
      • visibilityOf

        public static ExpectedCondition<org.openqa.selenium.WebElement> visibilityOf(org.openqa.selenium.WebElement element)
        An expectation for checking that an element, known to be present on the DOM of a page, is visible. Visibility means that the element is not only displayed but also has a height and width that is greater than 0.
        Parameters:
        element - the WebElement
        Returns:
        the (same) WebElement once it is visible
      • presenceOfAllElementsLocatedBy

        public static ExpectedCondition<List<org.openqa.selenium.WebElement>> presenceOfAllElementsLocatedBy(org.openqa.selenium.By locator)
        An expectation for checking that there is at least one element present on a web page.
        Parameters:
        locator - used to find the element
        Returns:
        the list of WebElements once they are located
      • textToBePresentInElement

        public static ExpectedCondition<Boolean> textToBePresentInElement(org.openqa.selenium.WebElement element,                                                                  String text)
        An expectation for checking if the given text is present in the specified element.
        Parameters:
        element - the WebElement
        text - to be present in the element
        Returns:
        true once the element contains the given text
      • textToBePresentInElement

        @Deprecatedpublic static ExpectedCondition<Boolean> textToBePresentInElement(org.openqa.selenium.By locator,                                                                              String text)
        An expectation for checking if the given text is present in the element that matches the given locator.
        Parameters:
        locator - used to find the element
        text - to be present in the element found by the locator
        Returns:
        the WebElement once it is located and visible
      • textToBePresentInElementLocated

        public static ExpectedCondition<Boolean> textToBePresentInElementLocated(org.openqa.selenium.By locator,                                                                         String text)
        An expectation for checking if the given text is present in the element that matches the given locator.
        Parameters:
        locator - used to find the element
        text - to be present in the element found by the locator
        Returns:
        true once the first element located by locator contains the given text
      • textToBePresentInElementValue

        public static ExpectedCondition<Boolean> textToBePresentInElementValue(org.openqa.selenium.WebElement element,                                                                       String text)
        An expectation for checking if the given text is present in the specified elements value attribute.
        Parameters:
        element - the WebElement
        text - to be present in the element's value attribute
        Returns:
        true once the element's value attribute contains the given text
      • textToBePresentInElementValue

        public static ExpectedCondition<Boolean> textToBePresentInElementValue(org.openqa.selenium.By locator,                                                                       String text)
        An expectation for checking if the given text is present in the specified elements value attribute.
        Parameters:
        locator - used to find the element
        text - to be present in the value attribute of the element found by the locator
        Returns:
        true once the value attribute of the first element located by locator contains the given text
      • frameToBeAvailableAndSwitchToIt

        public static ExpectedCondition<org.openqa.selenium.WebDriver> frameToBeAvailableAndSwitchToIt(String frameLocator)
        An expectation for checking whether the given frame is available to switch to.

        If the frame is available it switches the given driver to the specified frame.

        Parameters:
        frameLocator - used to find the frame (id or name)
        Returns:
        WebDriver instance after frame has been switched
      • frameToBeAvailableAndSwitchToIt

        public static ExpectedCondition<org.openqa.selenium.WebDriver> frameToBeAvailableAndSwitchToIt(org.openqa.selenium.By locator)
        An expectation for checking whether the given frame is available to switch to.

        If the frame is available it switches the given driver to the specified frame.

        Parameters:
        locator - used to find the frame
        Returns:
        WebDriver instance after frame has been switched
      • frameToBeAvailableAndSwitchToIt

        public static ExpectedCondition<org.openqa.selenium.WebDriver> frameToBeAvailableAndSwitchToIt(int frameLocator)
        An expectation for checking whether the given frame is available to switch to.

        If the frame is available it switches the given driver to the specified frameIndex.

        Parameters:
        frameLocator - used to find the frame (index)
        Returns:
        WebDriver instance after frame has been switched
      • frameToBeAvailableAndSwitchToIt

        public static ExpectedCondition<org.openqa.selenium.WebDriver> frameToBeAvailableAndSwitchToIt(org.openqa.selenium.WebElement frameLocator)
        An expectation for checking whether the given frame is available to switch to.

        If the frame is available it switches the given driver to the specified webelement.

        Parameters:
        frameLocator - used to find the frame (webelement)
        Returns:
        WebDriver instance after frame has been switched
      • invisibilityOfElementLocated

        public static ExpectedCondition<Boolean> invisibilityOfElementLocated(org.openqa.selenium.By locator)
        An expectation for checking that an element is either invisible or not present on the DOM.
        Parameters:
        locator - used to find the element
        Returns:
        true if the element is not displayed or the element doesn't exist or stale element
      • invisibilityOfElementWithText

        public static ExpectedCondition<Boolean> invisibilityOfElementWithText(org.openqa.selenium.By locator,                                                                       String text)
        An expectation for checking that an element with text is either invisible or not present on the DOM.
        Parameters:
        locator - used to find the element
        text - of the element
        Returns:
        true if no such element, stale element or displayed text not equal that provided
      • elementToBeClickable

        public static ExpectedCondition<org.openqa.selenium.WebElement> elementToBeClickable(org.openqa.selenium.By locator)
        An expectation for checking an element is visible and enabled such that you can click it.
        Parameters:
        locator - used to find the element
        Returns:
        the WebElement once it is located and clickable (visible and enabled)
      • elementToBeClickable

        public static ExpectedCondition<org.openqa.selenium.WebElement> elementToBeClickable(org.openqa.selenium.WebElement element)
        An expectation for checking an element is visible and enabled such that you can click it.
        Parameters:
        element - the WebElement
        Returns:
        the (same) WebElement once it is clickable (visible and enabled)
      • stalenessOf

        public static ExpectedCondition<Boolean> stalenessOf(org.openqa.selenium.WebElement element)
        Wait until an element is no longer attached to the DOM.
        Parameters:
        element - The element to wait for.
        Returns:
        false is the element is still attached to the DOM, true otherwise.
      • refreshed

        public static <T> ExpectedCondition<T> refreshed(ExpectedCondition<T> condition)
        Wrapper for a condition, which allows for elements to update by redrawing. This works around the problem of conditions which have two parts: find an element and then check for some condition on it. For these conditions it is possible that an element is located and then subsequently it is redrawn on the client. When this happens a StaleElementReferenceException is thrown when the second part of the condition is checked.
        Type Parameters:
        T - return type of the condition provided
        Parameters:
        condition - ExpectedCondition to wrap
        Returns:
        the result of the provided condition
      • elementToBeSelected

        public static ExpectedCondition<Boolean> elementToBeSelected(org.openqa.selenium.WebElement element)
        An expectation for checking if the given element is selected.
        Parameters:
        element - WebElement to be selected
        Returns:
        true once the element is selected
      • elementSelectionStateToBe

        public static ExpectedCondition<Boolean> elementSelectionStateToBe(org.openqa.selenium.WebElement element,                                                                   boolean selected)
        An expectation for checking if the given element is selected.
        Parameters:
        element - WebElement to be selected
        selected - boolean state of the selection state of the element
        Returns:
        true once the element's selection stated is that of selected
      • elementSelectionStateToBe

        public static ExpectedCondition<Boolean> elementSelectionStateToBe(org.openqa.selenium.By locator,                                                                   boolean selected)
      • alertIsPresent

        public static ExpectedCondition<org.openqa.selenium.Alert> alertIsPresent()
      • not

        public static ExpectedCondition<Boolean> not(ExpectedCondition<?> condition)
        An expectation with the logical opposite condition of the given condition. Note that if the Condition your are inverting throws an exception that is caught by the Ignored Exceptions, the inversion will not take place and lead to confusing results.
        Parameters:
        condition - ExpectedCondition to be inverted
        Returns:
        true once the condition is satisfied
      • attributeToBe

        public static ExpectedCondition<Boolean> attributeToBe(org.openqa.selenium.By locator,                                                       String attribute,                                                       String value)
        An expectation for checking WebElement with given locator has attribute with a specific value
        Parameters:
        locator - used to find the element
        attribute - used to define css or html attribute
        value - used as expected attribute value
        Returns:
        Boolean true when element has css or html attribute with the value
      • textToBe

        public static ExpectedCondition<Boolean> textToBe(org.openqa.selenium.By locator,                                                  String value)
        An expectation for checking WebElement with given locator has specific text
        Parameters:
        locator - used to find the element
        value - used as expected text
        Returns:
        Boolean true when element has text value equal to @value
      • textMatches

        public static ExpectedCondition<Boolean> textMatches(org.openqa.selenium.By locator,                                                     Pattern pattern)
        An expectation for checking WebElement with given locator has text with a value as a part of it
        Parameters:
        locator - used to find the element
        pattern - used as expected text matcher pattern
        Returns:
        Boolean true when element has text value containing @value
      • numberOfElementsToBeMoreThan

        public static ExpectedCondition<List<org.openqa.selenium.WebElement>> numberOfElementsToBeMoreThan(org.openqa.selenium.By locator,                                                                                                   Integer number)
        An expectation for checking number of WebElements with given locator
        Parameters:
        locator - used to find the element
        number - user to define exact number of elements
        Returns:
        Boolean true when size of elements list is equal to defined
      • numberOfElementsToBeLessThan

        public static ExpectedCondition<List<org.openqa.selenium.WebElement>> numberOfElementsToBeLessThan(org.openqa.selenium.By locator,                                                                                                   Integer number)
        An expectation for checking number of WebElements with given locator being less than defined number
        Parameters:
        locator - used to find the element
        number - user to define maximum number of elements
        Returns:
        Boolean true when size of elements list is less than defined
      • numberOfElementsToBe

        public static ExpectedCondition<List<org.openqa.selenium.WebElement>> numberOfElementsToBe(org.openqa.selenium.By locator,                                                                                           Integer number)
        An expectation for checking number of WebElements with given locator
        Parameters:
        locator - used to find the element
        number - user to define number of elements
        Returns:
        Boolean true when size of elements list is equal to defined
      • attributeToBe

        public static ExpectedCondition<Boolean> attributeToBe(org.openqa.selenium.WebElement element,                                                       String attribute,                                                       String value)
        An expectation for checking given WebElement has attribute with a specific value
        Parameters:
        element - used to check it's parameters
        attribute - used to define css or html attribute
        value - used as expected attribute value
        Returns:
        Boolean true when element has css or html attribute with the value
      • attributeContains

        public static ExpectedCondition<Boolean> attributeContains(org.openqa.selenium.WebElement element,                                                           String attribute,                                                           String value)
        An expectation for checking WebElement with given locator has attribute which contains specific value
        Parameters:
        element - used to check it's parameters
        attribute - used to define css or html attribute
        value - used as expected attribute value
        Returns:
        Boolean true when element has css or html attribute which contains the value
      • attributeContains

        public static ExpectedCondition<Boolean> attributeContains(org.openqa.selenium.By locator,                                                           String attribute,                                                           String value)
        An expectation for checking WebElement with given locator has attribute which contains specific value
        Parameters:
        locator - used to define WebElement to check it's parameters
        attribute - used to define css or html attribute
        value - used as expected attribute value
        Returns:
        Boolean true when element has css or html attribute which contains the value
      • attributeToBeNotEmpty

        public static ExpectedCondition<Boolean> attributeToBeNotEmpty(org.openqa.selenium.WebElement element,                                                               String attribute)
        An expectation for checking WebElement any non empty value for given attribute
        Parameters:
        element - used to check it's parameters
        attribute - used to define css or html attribute
        Returns:
        Boolean true when element has css or html attribute with non empty value
      • visibilityOfNestedElementsLocatedBy

        public static ExpectedCondition<List<org.openqa.selenium.WebElement>> visibilityOfNestedElementsLocatedBy(org.openqa.selenium.By locator,                                                                                                          org.openqa.selenium.By sub_locator)
        An expectation for checking child WebElement as a part of parent element to be visible
        Parameters:
        locator - used to check parent element. For example table with locator By.xpath("//table")
        sub_locator - used to find child element. For example td By.xpath("./tr/td")
        Returns:
        visible nested element
      • visibilityOfNestedElementsLocatedBy

        public static ExpectedCondition<List<org.openqa.selenium.WebElement>> visibilityOfNestedElementsLocatedBy(org.openqa.selenium.WebElement element,                                                                                                          org.openqa.selenium.By sub_locator)
        An expectation for checking child WebElement as a part of parent element to be visible
        Parameters:
        element - used as parent element. For example table with locator By.xpath("//table")
        sub_locator - used to find child element. For example td By.xpath("./tr/td")
        Returns:
        visible subelement
      • presenceOfNestedElementLocatedBy

        public static ExpectedCondition<org.openqa.selenium.WebElement> presenceOfNestedElementLocatedBy(org.openqa.selenium.By locator,                                                                                                 org.openqa.selenium.By sub_locator)
        An expectation for checking child WebElement as a part of parent element to present
        Parameters:
        locator - used to check parent element. For example table with locator By.xpath("//table")
        sub_locator - used to find child element. For example td By.xpath("./tr/td")
        Returns:
        subelement
      • presenceOfNestedElementLocatedBy

        public static ExpectedCondition<org.openqa.selenium.WebElement> presenceOfNestedElementLocatedBy(org.openqa.selenium.WebElement element,                                                                                                 org.openqa.selenium.By sub_locator)
        An expectation for checking child WebElement as a part of parent element to be present
        Parameters:
        element - used as parent element
        sub_locator - used to find child element. For example td By.xpath("./tr/td")
        Returns:
        subelement
      • presenceOfNestedElementsLocatedBy

        public static ExpectedCondition<List<org.openqa.selenium.WebElement>> presenceOfNestedElementsLocatedBy(org.openqa.selenium.By locator,                                                                                                        org.openqa.selenium.By sub_locator)
        An expectation for checking child WebElement as a part of parent element to present
        Parameters:
        locator - used to check parent element. For example table with locator By.xpath("//table")
        sub_locator - used to find child element. For example td By.xpath("./tr/td")
        Returns:
        subelement
      • invisibilityOfAllElements

        public static ExpectedCondition<Boolean> invisibilityOfAllElements(List<org.openqa.selenium.WebElement> elements)
        An expectation for checking all elements from given list to be invisible
        Parameters:
        elements - used to check their invisibility
        Returns:
        Boolean true when all elements are not visible anymore
      • or

        public static ExpectedCondition<Boolean> or(ExpectedCondition<?>... conditions)
        An expectation with the logical or condition of the given list of conditions. Each condition is checked until at leas one of them returns true or not null
        Parameters:
        conditions - ExpectedCondition is a list of alternative conditions
        Returns:
        true once one of conditions is satisfied
      • and

        public static ExpectedCondition<Boolean> and(ExpectedCondition<?>... conditions)
        An expectation with the logical and condition of the given list of conditions. Each condition is checked until all of them return true or not null
        Parameters:
        conditions - ExpectedCondition is a list of alternative conditions
        Returns:
        true once all conditions are satisfied
      • javaScriptThrowsNoExceptions

        public static ExpectedCondition<Boolean> javaScriptThrowsNoExceptions(String javaScript)
        An expectation to check if js executable Usefull when you know, that there should be js val or something at the stage
        Parameters:
        javaScript - used as executable script
        Returns:
        true once javaScript executed without errors
      • jsReturnsValue

        public static ExpectedCondition<Object> jsReturnsValue(String javaScript)
        An expectation for String value from javascript
        Parameters:
        javaScript - as executable js line
        Returns:
        true once js return string

Copyright © 2016. All rights reserved.



NOTHING
NOTHING
Add the Maven Dependecy to your project: maven dependecy for com.amazonaws : aws-java-sdk : 1.3.14