Location.reload()

The Location.reload() method reloads the resource from the current URL. Its optional unique parameter is a Boolean, which, when it is true, causes the page to always be reloaded from the server. If it is false or not specified, the browser may reload the page from its cache.

If the assignment can't happen because of a security violation, a DOMException of type SECURITY_ERROR is thrown. This happens if the origin of the script calling the method is different from the origin of the page originally described by the Location object, usually when the script is hosted on a different domain.

Syntax

object.reload(forcedReload);

Parameters

forcedReload Optional
Is a Boolean flag, which, when it is true, causes the page to always be reloaded from the server. If it is false or not specified, the browser may reload the page from its cache.

Examples

// Reload the current page, without using the cache
document.location.reload(true);

Specifications

Specification Status Comment
WHATWG HTML Living Standard
The definition of 'Location.reload()' in that specification.
Living Standard No change from HTML5.
HTML5
The definition of 'Location.reload()' in that specification.
Recommendation Initial definition.

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support (Yes) (Yes) (Yes) (Yes) (Yes)
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)

See also

Document Tags and Contributors

 Contributors to this page: chrisdavidmills, tomayac, fscholz, kscarfone, RustyTheBoyRobot, teoli
 Last updated by: chrisdavidmills,