Set Timeouts

The Set Timeouts command of the WebDriver API sets the timeouts associated with the current session. The session timeout durations control such behaviour as timeouts on script injection, document navigation, and element retrieval.


Method URI template
POST /session/{session id}/timeouts

URL parameters

session id
Identifier of the session.


The input is a Timeouts object:

Time in milliseconds to retry the element location strategy when finding an element. This defaults to 0, meaning the strategy is run only once.
Time in milliseconds to wait for the document to finish loading. By default, WebDriver will wait five minutes (or 300,000 ms).
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).


Invalid session ID
Session does not exist.


Specification Status Comment
The definition of 'Set Timeouts' in that specification.
Recommendation Initial definition

Browser compatibility

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support No1 No2557 No1 No3
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support No1 No1 No2 No No1 No3 No4

1. To enable Chromium support, include {"goog:chromeOptions": {"w3c": true}} in the capabiliites when running the command.

2. The vendor-supported implementation for Edge is non-spec-conforming and incompatible.

3. The vendor-supported implementation for Safari is non spec-conforming and incompatible.

4. The vendor-supported implementation for Samsung Internet is non-spec-conforming and incompatible.

See also

Document Tags and Contributors

Contributors to this page: PushpitaPikuDey, fscholz, automatedtester
Last updated by: PushpitaPikuDey,