Forward

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

MethodURI 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 window object has been discarded, indicating that the tab or window has been closed.

timeout

The navigation did not complete before its timeout expired.

Examples

undefined

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:

bash
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
HTTP/1.1 200 OK
content-type: application/json; charset=utf-8

{"value":null}

Specifications

See also