Forward
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
The Forward command of the WebDriver API navigates to the next page in the browsing history. This is equivalent to clicking the browser's forward button or calling History.forward() in JavaScript.
Syntax
| Method | URI template |
|---|---|
POST |
/session/{session id}/forward |
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 forward in browsing history
With a WebDriver server running on localhost:4444, assume an active session has navigated to at least two pages and gone back. To navigate forward to the next page, use the forward command, replacing ID with the sessionId from the New Session response:
curl -i -H "Content-Type: application/json" -d '{}' http://localhost:4444/session/ID/forward
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 # forward |