W3cubDocs

/Web APIs

Document: location property

The Document.location read-only property returns a Location object, which contains information about the URL of the document and provides methods for changing that URL and loading another URL.

Though Document.location is a read-only Location object, you can also assign a string to it. This means that you can work with document.location as if it were a string in most cases: document.location = 'http://www.example.com' is a synonym of document.location.href = 'http://www.example.com'. If you assign another string to it, browser will load the website you assigned.

To retrieve just the URL as a string, the read-only document.URL property can also be used.

If the current document is not in a browsing context, the returned value is null.

Value

A Location object.

Examples

js

console.log(document.location);
// Prints a Location object to the console

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
location 1 12 1 4 3 1 4.4 18 4 10.1 1 1.0

See also

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Document/location