Name

Document.URL — the URL of the current document

Availability

JavaScript 1.1

Synopsis

                  document.URL

Description

URL is a read-only string property that contains the complete URL of the current document.

document .URL is usually equal to window .location.href for the window that contains document. These two are not always equal, however, because the Document.URL property may be modified through URL redirection -- Window.location contains the requested URL, and Document.URL specifies the actual URL where it was found.

Usage

Some web authors like to include the URL of a document somewhere within the document so, for example, if the document is cut-and-pasted to a file or printed out, there is still a reference to its location online. The following script, when appended to a document, automatically adds the document’s URL:

<script>
document.write('<p><hr><small><i>URL: ' + document.URL
    + '</i></small>');
</script>

See Also

The lastModified, location, referrer, and title properties of the Document object; the location property of the Window object

Get JavaScript: The Definitive Guide, Fourth Edition now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.