Syntax

Parameters

url

A string or any other object with a stringifier, such as a URL object, containing the URL of the page to navigate to.

Exceptions

SecurityError DOMException

Browsers throttle navigations and may throw this error, generate a warning, or ignore the call if it's called too frequently.

SyntaxError DOMException

Thrown if the provided url parameter is not a valid URL.

Return value

None (undefined).

Examples

// Navigate to the Location.reload article by replacing this page
window.location.replace(
  "https://developer.mozilla.org/en-US/docs/Web/API/Location.reload",
);

Specifications

Browser compatibility

See also

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