The read-onlylocation property of theDocument interface returns aLocation object, which contains information about the URL of the document and provides methods for changing that URL and loading another URL.

To retrieve just the URL as a string, the read-onlydocument.URLproperty can also be used.

Value

ALocation object. If the current document is not in a browsing context, the returned value isnull.

Although thelocation property itself is read-only in the sense that you can't replace theLocation object, you can still assign to thelocation property directly, which is equivalent to assigning to itshref property. You can also modify theLocation object using theassign() andreplace() methods.

Examples

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

Specifications

Browser compatibility

See also

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