Document: location property
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 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
console.log(document.location);
// Prints a Location object to the console
Specifications
| Specification |
|---|
| HTML # the-location-interface |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
location | ||||||||||||
See also
- The interface of the returned value,
Location - A similar information, but attached to the browsing context,
Window.location