Interface WebDriver.Timeouts
-
- Enclosing interface:
- WebDriver
public static interface WebDriver.Timeouts
An interface for managing timeout behavior for WebDriver instances.See W3C WebDriver specification for more details.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Default Methods Deprecated Methods Modifier and Type Method Description WebDriver.Timeouts
implicitlyWait(long time, java.util.concurrent.TimeUnit unit)
Deprecated.UseimplicitlyWait(Duration)
Specifies the amount of time the driver should wait when searching for an element if it is not immediately present.default WebDriver.Timeouts
implicitlyWait(java.time.Duration duration)
Specifies the amount of time the driver should wait when searching for an element if it is not immediately present.WebDriver.Timeouts
pageLoadTimeout(long time, java.util.concurrent.TimeUnit unit)
Deprecated.UsepageLoadTimeout(Duration)
Sets the amount of time to wait for a page load to complete before throwing an error.default WebDriver.Timeouts
pageLoadTimeout(java.time.Duration duration)
Sets the amount of time to wait for a page load to complete before throwing an error.WebDriver.Timeouts
setScriptTimeout(long time, java.util.concurrent.TimeUnit unit)
Deprecated.UsesetScriptTimeout(Duration)
Sets the amount of time to wait for an asynchronous script to finish execution before throwing an error.default WebDriver.Timeouts
setScriptTimeout(java.time.Duration duration)
Sets the amount of time to wait for an asynchronous script to finish execution before throwing an error.
-
-
-
Method Detail
-
implicitlyWait
@Deprecated WebDriver.Timeouts implicitlyWait(long time, java.util.concurrent.TimeUnit unit)
Deprecated.UseimplicitlyWait(Duration)
Specifies the amount of time the driver should wait when searching for an element if it is not immediately present.When searching for a single element, the driver should poll the page until the element has been found, or this timeout expires before throwing a
NoSuchElementException
. When searching for multiple elements, the driver should poll the page until at least one element has been found or this timeout has expired.Increasing the implicit wait timeout should be used judiciously as it will have an adverse effect on test run time, especially when used with slower location strategies like XPath.
- Parameters:
time
- The amount of time to wait.unit
- The unit of measure fortime
.- Returns:
- A self reference.
-
implicitlyWait
default WebDriver.Timeouts implicitlyWait(java.time.Duration duration)
Specifies the amount of time the driver should wait when searching for an element if it is not immediately present.When searching for a single element, the driver should poll the page until the element has been found, or this timeout expires before throwing a
NoSuchElementException
. When searching for multiple elements, the driver should poll the page until at least one element has been found or this timeout has expired.Increasing the implicit wait timeout should be used judiciously as it will have an adverse effect on test run time, especially when used with slower location strategies like XPath.
- Parameters:
duration
- The duration to wait.- Returns:
- A self reference.
-
setScriptTimeout
@Deprecated WebDriver.Timeouts setScriptTimeout(long time, java.util.concurrent.TimeUnit unit)
Deprecated.UsesetScriptTimeout(Duration)
Sets the amount of time to wait for an asynchronous script to finish execution before throwing an error. If the timeout is negative, then the script will be allowed to run indefinitely.- Parameters:
time
- The timeout value.unit
- The unit of time.- Returns:
- A self reference.
- See Also:
JavascriptExecutor.executeAsyncScript(String, Object...)
-
setScriptTimeout
default WebDriver.Timeouts setScriptTimeout(java.time.Duration duration)
Sets the amount of time to wait for an asynchronous script to finish execution before throwing an error. If the timeout is negative, then the script will be allowed to run indefinitely.- Parameters:
duration
- The timeout value.- Returns:
- A self reference.
- See Also:
JavascriptExecutor.executeAsyncScript(String, Object...)
-
pageLoadTimeout
@Deprecated WebDriver.Timeouts pageLoadTimeout(long time, java.util.concurrent.TimeUnit unit)
Deprecated.UsepageLoadTimeout(Duration)
Sets the amount of time to wait for a page load to complete before throwing an error. The timeout value specified should be a positive number.- Parameters:
time
- The timeout value.unit
- The unit of time.- Returns:
- A Timeouts interface.
-
pageLoadTimeout
default WebDriver.Timeouts pageLoadTimeout(java.time.Duration duration)
Sets the amount of time to wait for a page load to complete before throwing an error. If the timeout is negative, page loads can be indefinite.- Parameters:
duration
- The timeout value.- Returns:
- A Timeouts interface.
-
-