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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
SetTimeouts

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.

See also