Document.location

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 DOMString 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'.

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.

Syntax

locationObj = document.location
document.location = 'http://www.mozilla.org' // Equivalent to document.location.href = 'http://www.mozilla.org'

Example

dump(document.location); 
// Prints a string like
// "http://www.example.com/juicybits.html" to the console

Specifications

Browser compatibility

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

See also

• The interface of the returned value, Location.
• A similar information, but attached to the browsing context, Window.location.