Back
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
The Back command of the WebDriver API navigates to the previous page in the browsing history. This is equivalent to clicking the browser's back button or calling History.back() in JavaScript.
Syntax
| Method | URI template |
|---|---|
POST |
/session/{session id}/back |
URL parameters
session id-
Identifier of the session.
Return value
null if successful.
Errors
- Invalid session id
-
Session does not exist.
- No such window
-
The
windowobject has been discarded, indicating that the tab or window has been closed. - Timeout
-
The navigation did not complete before its timeout expired.
Examples
Navigating back in browsing history
With a WebDriver server running on localhost:4444, assume an active session has navigated to at least two pages. To navigate back to the previous page, use the back command, replacing ID with the sessionId from the New Session response:
curl -i -H "Content-Type: application/json" -d '{}' http://localhost:4444/session/ID/back
The server responds with a null value to indicate success:
HTTP/1.1 200 OK
content-type: application/json; charset=utf-8
{"value":null}
Specifications
| Specification |
|---|
| WebDriver # back |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
Back
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support
- See implementation notes.