The Location.reload() method reloads the current resource, like the Refresh button.

This method has an optional Boolean parameter, which is false by default. If true, the page is always reloaded from the server, ignoring the browser cache.

The forcedReload flag changes how some browsers handle the user's scroll position. Usually reload() restores the scroll position afterward, but forced mode can scroll back to the top of the page, as if window.scrollY === 0.

The reload may be blocked and a SECURITY_ERROR DOMException thrown. This happens if the origin of the script calling Location.reload() differs from the origin of the page that owns the Location object. See Same-origin policy for more information.

Syntax

object.reload(forcedReload);

Parameters

forcedReload Optional
A Boolean parameter. If true, the page will always reload from the server. If false or unspecified, the browser may reload the page from its HTTP cache.

Example

// Reload the current page without the browser cache
location.reload(true);

Specifications

Specification Status Comment
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

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
Basic supportChrome Full support YesEdge Full support YesFirefox Full support YesIE Full support YesOpera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesEdge Mobile Full support YesFirefox Android Full support YesOpera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yes

Legend

Full support  
Full support

See also

Document Tags and Contributors

Last updated by: mfluehr,