Refresh

The Refresh command of the WebDriver API reloads the current page in the active browsing context. This is equivalent to clicking the browser's reload button or calling Location.reload() in JavaScript.

Syntax

MethodURI template
POST/session/{session id}/refresh

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.

unexpected alert open

A modal dialog was open, blocking this operation.

Examples

undefined

Reloading the current page

With a WebDriver server running on localhost:4444, assume an active session has navigated to a page. To reload the current page, use the refresh 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/refresh

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