Set Timeouts
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
The Set Timeouts command of the WebDriver API sets the timeouts associated with the current session. The session timeout durations control such behavior as timeouts on script injection, document navigation, and element retrieval.
Syntax
| Method | URI template |
|---|---|
POST |
/session/{session id}/timeouts |
URL parameters
session id-
Identifier of the session.
Payload
The input is a Timeouts object:
implicit-
Time in milliseconds to retry the element location strategy when finding an element. This defaults to 0, meaning the strategy is run only once.
pageLoad-
Time in milliseconds to wait for the document to finish loading. By default, WebDriver will wait five minutes (or 300,000 ms).
script-
Scripts injected with Execute Script or Execute Async Script will run until they hit the script timeout duration, which is also given in milliseconds. The scripts will then be interrupted and a script timeout error will be returned. Defaults to 30 seconds (or 30,000 ms).
Errors
- Invalid session ID
-
Session does not exist.
Specifications
| Specification |
|---|
| WebDriver # set-timeouts |
Browser compatibility
BCD tables only load in the browser