Refresh

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

See full compatibility

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 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

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

Specification
WebDriver # refresh

Browser compatibility

	desktop					mobile
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on iOS	Samsung Internet	WebView Android	WebView on iOS
`Refresh`	Chrome – Full support Chrome 65 (Release date: 2018-03-06) footnote footnote To enable Chromium support, include `{"goog:chromeOptions": {"w3c": true}}` in the capabilities.	Edge – Full support Edge 79 (Release date: 2020-01-15) footnote footnote To enable Chromium support, include `{"goog:chromeOptions": {"w3c": true}}` in the capabilities.	Firefox – Full support Firefox 55 (Release date: 2017-08-08) footnote Full support	Opera – No support Opera footnote footnote To enable Chromium support, include `{"goog:chromeOptions": {"w3c": true}}` in the capabilities.	Safari – No support Safari footnote footnote The vendor-supported implementation for Safari is non spec-conforming and incompatible.	Chrome Android – No support Chrome Android footnote footnote To enable Chromium support, include `{"goog:chromeOptions": {"w3c": true}}` in the capabilities.	Firefox for Android – No support Firefox for Android footnote No support	Opera Android – No support Opera Android footnote footnote To enable Chromium support, include `{"goog:chromeOptions": {"w3c": true}}` in the capabilities.	Safari on iOS – No support Safari on iOS footnote footnote The vendor-supported implementation for Safari on iOS is non spec-conforming and incompatible.	Samsung Internet – No support Samsung Internet footnote footnote The vendor-supported implementation for Samsung Internet is non-spec-conforming and incompatible.	WebView Android – No support WebView Android footnote footnote To enable Chromium support, include `{"goog:chromeOptions": {"w3c": true}}` in the capabilities.	WebView on iOS – No support WebView on iOS footnote footnote The vendor-supported implementation for WebView on iOS is non spec-conforming and incompatible.

Tip: you can click/tap on a cell for more information.

Full support: Full support
No support: No support
: See implementation notes.

Refresh

Legend