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. Besides caching behaviour forcedReload
flag also impacts how some browsers handle scroll position: ordinary reload happens to try to restore scroll position after reloading page DOM, while in forced mode (when parameter is set to true
) the new DOM gets loaded with scrollTop == 0
.
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 istrue
, causes the page to always be reloaded from the server. If it isfalse
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
- The
Location
interface it belongs to. - Similar methods:
Location.assign()
andLocation.replace()
.
License
© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/api/location/reload