Document: location property
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("DOM")}}
The read-only **location** property of the {{domxref("Document")}} interface returns a {{domxref("Location")}} 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-only {{domxref("document.URL")}} property can also be used.
Value
A {{domxref("Location")}} object. If the current document is not in a browsing context, the returned value is null.
Although the location property itself is read-only in the sense that you can't replace the Location object, you can still assign to the location property directly, which is equivalent to assigning to its {{domxref("Location/href", "href")}} property. You can also modify the Location object using the {{domxref("Location/assign", "assign()")}} and {{domxref("Location/replace", "replace()")}} methods.
Examples
console.log(document.location);
// Prints a Location object to the consoleSpecifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- The interface of the returned value, {{domxref("Location")}}
- A similar information, but attached to the {{Glossary("browsing context")}},
{{domxref("Window.location")}}