Refresh
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
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
| Method | URI 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
windowobject has been discarded, indicating that the tab or window has been closed. - Unexpected alert open
-
A modal dialog was open, blocking this operation.
Examples
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:
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/1.1 200 OK
content-type: application/json; charset=utf-8
{"value":null}
Specifications
| Specification |
|---|
| WebDriver # refresh |