Location: assign() method

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

The assign() method of the Location interface causes the window to load and display the document at the URL specified. After the navigation occurs, the user can navigate back to the page that called Location.assign() by pressing the "back" button.

Syntax

js
assign(url)

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; for example, an absolute URL such as https://developer.mozilla.org/en-US/docs/Web/API/Location/reload, or a relative URL — such as /Web (just a path, for navigating to another document at the same origin) or #specifications (just a fragment string, for navigating to some part of the same page), and so on.

Exceptions

SecurityError DOMException

Thrown if the origin of the script calling the method is not the same origin of the page originally described by the Location object, mostly when the script is hosted on a different domain. Browsers also 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

js
// Navigate to the Location.reload article
window.location.assign(
  "https://developer.mozilla.org/en-US/docs/Web/API/Location/reload",
);

// Then navigate to its Specifications section
window.location.assign("#specifications");

// Eventually navigate to https://developer.mozilla.org/en-US/docs/Web
window.location.assign("/Web");

Specifications

Specification
HTML Standard
# dom-location-assign-dev

Browser compatibility

BCD tables only load in the browser

See also