io.devcon5.pageobjects

Class WebElementLocator

java.lang.Object

io.devcon5.pageobjects.WebElementLocator

public final class WebElementLocator
extends Object

Helper class to locate WebElements by a Locator literal

Method Summary

Modifier and Type	Method and Description
static org.openqa.selenium.WebElement	locate(Locator loc) Locates the element using the current driver as search context.
static org.openqa.selenium.WebElement	locate(org.openqa.selenium.SearchContext context, Locator loc) Locates the element using the search context and locator, waiting for the timeout specified in the locator.
static Optional<org.openqa.selenium.WebElement>	waitForElement(org.openqa.selenium.By by, int waitSec) Waits for the presence of an element until a timeout is reached.
static Optional<org.openqa.selenium.WebElement>	waitForElement(org.openqa.selenium.SearchContext context, org.openqa.selenium.By by, int waitSec) Waits for the presence of a specific web element until a timeout is reached.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

locate

public static org.openqa.selenium.WebElement locate(Locator loc)

Locates the element using the current driver as search context.

Parameters:

loc - the locator to specify the element to locate

Returns:

the web element found by the locator. If the element could not be found a NoSuchElementException is thrown

locate

public static org.openqa.selenium.WebElement locate(org.openqa.selenium.SearchContext context,
                                                    Locator loc)

Locates the element using the search context and locator, waiting for the timeout specified in the locator.

Parameters:

context - the search context to locate the element in

loc - the locator to specify the element

Returns:

the web element found by the locator. If the element could not be found a NoSuchElementException is thrown

waitForElement

public static Optional<org.openqa.selenium.WebElement> waitForElement(org.openqa.selenium.SearchContext context,
                                                                      org.openqa.selenium.By by,
                                                                      int waitSec)

Waits for the presence of a specific web element until a timeout is reached. The method will succeed in any case. If the element is not present, the method waits until the timeout, otherwise it returns as soon as the element is present

Parameters:

context - the search context in which the element should be located

by - the locate for the element

waitSec - the timeout in seconds

Returns:

the located element

waitForElement

public static Optional<org.openqa.selenium.WebElement> waitForElement(org.openqa.selenium.By by,
                                                                      int waitSec)

Waits for the presence of an element until a timeout is reached.

Parameters:

by - the locator for the element

waitSec - the timeout. If the timeout is reached, a NoSuchElementException is thrown

Returns:

the element found