public class ExpectedConditions extends Object
ExpectedConditions which are generally useful within webdriver tests.| 限定符和类型 | 方法和说明 |
|---|---|
static ExpectedCondition<Alert> |
alertIsPresent() |
static ExpectedCondition<Boolean> |
and(ExpectedCondition<?>... conditions)
An expectation with the logical and condition of the given list of conditions.
|
static ExpectedCondition<Boolean> |
attributeContains(By locator,
String attribute,
String value)
An expectation for checking WebElement with given locator has attribute which contains specific
value
|
static ExpectedCondition<Boolean> |
attributeContains(WebElement element,
String attribute,
String value)
An expectation for checking WebElement with given locator has attribute which contains specific
value
|
static ExpectedCondition<Boolean> |
attributeToBe(By locator,
String attribute,
String value)
An expectation for checking WebElement with given locator has attribute with a specific value
|
static ExpectedCondition<Boolean> |
attributeToBe(WebElement element,
String attribute,
String value)
An expectation for checking given WebElement has attribute with a specific value
|
static ExpectedCondition<Boolean> |
attributeToBeNotEmpty(WebElement element,
String attribute)
An expectation for checking WebElement any non empty value for given attribute
|
static ExpectedCondition<Boolean> |
elementSelectionStateToBe(By locator,
boolean selected) |
static ExpectedCondition<Boolean> |
elementSelectionStateToBe(WebElement element,
boolean selected)
An expectation for checking if the given element is selected.
|
static ExpectedCondition<WebElement> |
elementToBeClickable(By locator)
An expectation for checking an element is visible and enabled such that you can click it.
|
static ExpectedCondition<WebElement> |
elementToBeClickable(WebElement element)
An expectation for checking an element is visible and enabled such that you can click it.
|
static ExpectedCondition<Boolean> |
elementToBeSelected(By locator) |
static ExpectedCondition<Boolean> |
elementToBeSelected(WebElement element)
An expectation for checking if the given element is selected.
|
static ExpectedCondition<WebDriver> |
frameToBeAvailableAndSwitchToIt(By locator)
An expectation for checking whether the given frame is available to switch to.
|
static ExpectedCondition<WebDriver> |
frameToBeAvailableAndSwitchToIt(int frameLocator)
An expectation for checking whether the given frame is available to switch to.
|
static ExpectedCondition<WebDriver> |
frameToBeAvailableAndSwitchToIt(String frameLocator)
An expectation for checking whether the given frame is available to switch to.
|
static ExpectedCondition<WebDriver> |
frameToBeAvailableAndSwitchToIt(WebElement frameLocator)
An expectation for checking whether the given frame is available to switch to.
|
static ExpectedCondition<Boolean> |
invisibilityOfAllElements(List<WebElement> elements)
An expectation for checking all elements from given list to be invisible
|
static ExpectedCondition<Boolean> |
invisibilityOfElementLocated(By locator)
An expectation for checking that an element is either invisible or not present on the DOM.
|
static ExpectedCondition<Boolean> |
invisibilityOfElementWithText(By locator,
String text)
An expectation for checking that an element with text is either invisible or not present on the
DOM.
|
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
|
static ExpectedCondition<Object> |
jsReturnsValue(String javaScript)
An expectation for String value from javascript
|
static ExpectedCondition<Boolean> |
not(ExpectedCondition<?> condition)
An expectation with the logical opposite condition of the given condition.
|
static ExpectedCondition<List<WebElement>> |
numberOfElementsToBe(By locator,
Integer number)
An expectation for checking number of WebElements with given locator
|
static ExpectedCondition<List<WebElement>> |
numberOfElementsToBeLessThan(By locator,
Integer number)
An expectation for checking number of WebElements with given locator being less than defined
number
|
static ExpectedCondition<List<WebElement>> |
numberOfElementsToBeMoreThan(By locator,
Integer number)
An expectation for checking number of WebElements with given locator
|
static ExpectedCondition<Boolean> |
numberOfwindowsToBe(int expectedNumberOfWindows)
已过时。
please use
numberOfWindowsToBe(int) instead |
static ExpectedCondition<Boolean> |
numberOfWindowsToBe(int expectedNumberOfWindows) |
static ExpectedCondition<Boolean> |
or(ExpectedCondition<?>... conditions)
An expectation with the logical or condition of the given list of conditions.
|
static ExpectedCondition<List<WebElement>> |
presenceOfAllElementsLocatedBy(By locator)
An expectation for checking that there is at least one element present on a web page.
|
static ExpectedCondition<WebElement> |
presenceOfElementLocated(By locator)
An expectation for checking that an element is present on the DOM of a page.
|
static ExpectedCondition<WebElement> |
presenceOfNestedElementLocatedBy(By locator,
By sub_locator)
An expectation for checking child WebElement as a part of parent element to present
|
static ExpectedCondition<WebElement> |
presenceOfNestedElementLocatedBy(WebElement element,
By sub_locator)
An expectation for checking child WebElement as a part of parent element to be present
|
static ExpectedCondition<List<WebElement>> |
presenceOfNestedElementsLocatedBy(By locator,
By sub_locator)
An expectation for checking child WebElement as a part of parent element to present
|
static <T> ExpectedCondition<T> |
refreshed(ExpectedCondition<T> condition)
Wrapper for a condition, which allows for elements to update by redrawing.
|
static ExpectedCondition<Boolean> |
stalenessOf(WebElement element)
Wait until an element is no longer attached to the DOM.
|
static ExpectedCondition<Boolean> |
textMatches(By locator,
Pattern pattern)
An expectation for checking WebElement with given locator has text with a value as a part of
it
|
static ExpectedCondition<Boolean> |
textToBe(By locator,
String value)
An expectation for checking WebElement with given locator has specific text
|
static ExpectedCondition<Boolean> |
textToBePresentInElement(By locator,
String text)
已过时。
Use
textToBePresentInElementLocated(By, String) instead |
static ExpectedCondition<Boolean> |
textToBePresentInElement(WebElement element,
String text)
An expectation for checking if the given text is present in the specified element.
|
static ExpectedCondition<Boolean> |
textToBePresentInElementLocated(By locator,
String text)
An expectation for checking if the given text is present in the element that matches the given
locator.
|
static ExpectedCondition<Boolean> |
textToBePresentInElementValue(By locator,
String text)
An expectation for checking if the given text is present in the specified elements value
attribute.
|
static ExpectedCondition<Boolean> |
textToBePresentInElementValue(WebElement element,
String text)
An expectation for checking if the given text is present in the specified elements value
attribute.
|
static ExpectedCondition<Boolean> |
titleContains(String title)
An expectation for checking that the title contains a case-sensitive substring
|
static ExpectedCondition<Boolean> |
titleIs(String title)
An expectation for checking the title of a page.
|
static ExpectedCondition<Boolean> |
urlContains(String fraction)
An expectation for the URL of the current page to contain specific text.
|
static ExpectedCondition<Boolean> |
urlMatches(String regex)
Expectation for the URL to match a specific regular expression
|
static ExpectedCondition<Boolean> |
urlToBe(String url)
An expectation for the URL of the current page to be a specific url.
|
static ExpectedCondition<WebElement> |
visibilityOf(WebElement element)
An expectation for checking that an element, known to be present on the DOM of a page, is
visible.
|
static ExpectedCondition<List<WebElement>> |
visibilityOfAllElements(List<WebElement> elements)
An expectation for checking that all elements present on the web page that match the locator
are visible.
|
static ExpectedCondition<List<WebElement>> |
visibilityOfAllElementsLocatedBy(By locator)
An expectation for checking that all elements present on the web page that match the locator
are visible.
|
static ExpectedCondition<WebElement> |
visibilityOfElementLocated(By locator)
An expectation for checking that an element is present on the DOM of a page and visible.
|
static ExpectedCondition<List<WebElement>> |
visibilityOfNestedElementsLocatedBy(By locator,
By sub_locator)
An expectation for checking child WebElement as a part of parent element to be visible
|
static ExpectedCondition<List<WebElement>> |
visibilityOfNestedElementsLocatedBy(WebElement element,
By sub_locator)
An expectation for checking child WebElement as a part of parent element to be visible
|
public static ExpectedCondition<Boolean> titleIs(String title)
title - the expected title, which must be an exact matchpublic static ExpectedCondition<Boolean> titleContains(String title)
title - the fragment of title expectedpublic static ExpectedCondition<Boolean> urlToBe(String url)
url - the url that the page should be ontrue when the URL is what it should bepublic static ExpectedCondition<Boolean> urlContains(String fraction)
fraction - the fraction of the url that the page should be ontrue when the URL contains the textpublic static ExpectedCondition<Boolean> urlMatches(String regex)
regex - the regular expression that the URL should matchtrue if the URL matches the specified regular expressionpublic static ExpectedCondition<WebElement> presenceOfElementLocated(By locator)
locator - used to find the elementpublic static ExpectedCondition<WebElement> visibilityOfElementLocated(By locator)
locator - used to find the elementpublic static ExpectedCondition<List<WebElement>> visibilityOfAllElementsLocatedBy(By locator)
locator - used to find the elementpublic static ExpectedCondition<List<WebElement>> visibilityOfAllElements(List<WebElement> elements)
elements - list of WebElementspublic static ExpectedCondition<WebElement> visibilityOf(WebElement element)
element - the WebElementpublic static ExpectedCondition<List<WebElement>> presenceOfAllElementsLocatedBy(By locator)
locator - used to find the elementpublic static ExpectedCondition<Boolean> textToBePresentInElement(WebElement element, String text)
element - the WebElementtext - to be present in the element@Deprecated public static ExpectedCondition<Boolean> textToBePresentInElement(By locator, String text)
textToBePresentInElementLocated(By, String) insteadlocator - used to find the elementtext - to be present in the element found by the locatorpublic static ExpectedCondition<Boolean> textToBePresentInElementLocated(By locator, String text)
locator - used to find the elementtext - to be present in the element found by the locatorpublic static ExpectedCondition<Boolean> textToBePresentInElementValue(WebElement element, String text)
element - the WebElementtext - to be present in the element's value attributepublic static ExpectedCondition<Boolean> textToBePresentInElementValue(By locator, String text)
locator - used to find the elementtext - to be present in the value attribute of the element found by the locatorpublic static ExpectedCondition<WebDriver> frameToBeAvailableAndSwitchToIt(String frameLocator)
If the frame is available it switches the given driver to the specified frame.
frameLocator - used to find the frame (id or name)public static ExpectedCondition<WebDriver> frameToBeAvailableAndSwitchToIt(By locator)
If the frame is available it switches the given driver to the specified frame.
locator - used to find the framepublic static ExpectedCondition<WebDriver> frameToBeAvailableAndSwitchToIt(int frameLocator)
If the frame is available it switches the given driver to the specified frameIndex.
frameLocator - used to find the frame (index)public static ExpectedCondition<WebDriver> frameToBeAvailableAndSwitchToIt(WebElement frameLocator)
If the frame is available it switches the given driver to the specified webelement.
frameLocator - used to find the frame (webelement)public static ExpectedCondition<Boolean> invisibilityOfElementLocated(By locator)
locator - used to find the elementpublic static ExpectedCondition<Boolean> invisibilityOfElementWithText(By locator, String text)
locator - used to find the elementtext - of the elementpublic static ExpectedCondition<WebElement> elementToBeClickable(By locator)
locator - used to find the elementpublic static ExpectedCondition<WebElement> elementToBeClickable(WebElement element)
element - the WebElementpublic static ExpectedCondition<Boolean> stalenessOf(WebElement element)
element - The element to wait for.public static <T> ExpectedCondition<T> refreshed(ExpectedCondition<T> condition)
StaleElementReferenceException is thrown when the second part of the condition is checked.T - return type of the condition providedcondition - ExpectedCondition to wrappublic static ExpectedCondition<Boolean> elementToBeSelected(WebElement element)
element - WebElement to be selectedpublic static ExpectedCondition<Boolean> elementSelectionStateToBe(WebElement element, boolean selected)
element - WebElement to be selectedselected - boolean state of the selection state of the elementpublic static ExpectedCondition<Boolean> elementToBeSelected(By locator)
public static ExpectedCondition<Boolean> elementSelectionStateToBe(By locator, boolean selected)
public static ExpectedCondition<Alert> alertIsPresent()
@Deprecated public static ExpectedCondition<Boolean> numberOfwindowsToBe(int expectedNumberOfWindows)
numberOfWindowsToBe(int) insteadpublic static ExpectedCondition<Boolean> numberOfWindowsToBe(int expectedNumberOfWindows)
public static ExpectedCondition<Boolean> not(ExpectedCondition<?> condition)
condition - ExpectedCondition to be invertedpublic static ExpectedCondition<Boolean> attributeToBe(By locator, String attribute, String value)
locator - used to find the elementattribute - used to define css or html attributevalue - used as expected attribute valuepublic static ExpectedCondition<Boolean> textToBe(By locator, String value)
locator - used to find the elementvalue - used as expected textpublic static ExpectedCondition<Boolean> textMatches(By locator, Pattern pattern)
locator - used to find the elementpattern - used as expected text matcher patternpublic static ExpectedCondition<List<WebElement>> numberOfElementsToBeMoreThan(By locator, Integer number)
locator - used to find the elementnumber - user to define exact number of elementspublic static ExpectedCondition<List<WebElement>> numberOfElementsToBeLessThan(By locator, Integer number)
locator - used to find the elementnumber - user to define maximum number of elementspublic static ExpectedCondition<List<WebElement>> numberOfElementsToBe(By locator, Integer number)
locator - used to find the elementnumber - user to define number of elementspublic static ExpectedCondition<Boolean> attributeToBe(WebElement element, String attribute, String value)
element - used to check it's parametersattribute - used to define css or html attributevalue - used as expected attribute valuepublic static ExpectedCondition<Boolean> attributeContains(WebElement element, String attribute, String value)
element - used to check it's parametersattribute - used to define css or html attributevalue - used as expected attribute valuepublic static ExpectedCondition<Boolean> attributeContains(By locator, String attribute, String value)
locator - used to define WebElement to check it's parametersattribute - used to define css or html attributevalue - used as expected attribute valuepublic static ExpectedCondition<Boolean> attributeToBeNotEmpty(WebElement element, String attribute)
element - used to check it's parametersattribute - used to define css or html attributepublic static ExpectedCondition<List<WebElement>> visibilityOfNestedElementsLocatedBy(By locator, By sub_locator)
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")public static ExpectedCondition<List<WebElement>> visibilityOfNestedElementsLocatedBy(WebElement element, By sub_locator)
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")public static ExpectedCondition<WebElement> presenceOfNestedElementLocatedBy(By locator, By sub_locator)
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")public static ExpectedCondition<WebElement> presenceOfNestedElementLocatedBy(WebElement element, By sub_locator)
element - used as parent elementsub_locator - used to find child element. For example td By.xpath("./tr/td")public static ExpectedCondition<List<WebElement>> presenceOfNestedElementsLocatedBy(By locator, By sub_locator)
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")public static ExpectedCondition<Boolean> invisibilityOfAllElements(List<WebElement> elements)
elements - used to check their invisibilitypublic static ExpectedCondition<Boolean> or(ExpectedCondition<?>... conditions)
conditions - ExpectedCondition is a list of alternative conditionspublic static ExpectedCondition<Boolean> and(ExpectedCondition<?>... conditions)
conditions - ExpectedCondition is a list of alternative conditionspublic static ExpectedCondition<Boolean> javaScriptThrowsNoExceptions(String javaScript)
javaScript - used as executable scriptpublic static ExpectedCondition<Object> jsReturnsValue(String javaScript)
javaScript - as executable js line