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 the forcedReload flag also impacts how some browsers handle the scroll position: ordinary reload tries to restore the scroll position after reloading the page, 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 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
window.location.reload(true);

Specifications

Browser compatibility

See also

• The Location interface it belongs to.
• Similar methods: Location.assign() and Location.replace().