The JavaScript Diaries: Part 10/Page 5 | WebReference

The JavaScript Diaries: Part 10/Page 5


[previous] [next]

The JavaScript Diaries: Part 10

The location Object

This object provides access to and control over the URL of the current window. For security reasons, it cannot modify the URL displayed in the browser's address box.

PropertiesMethods
hash
host
hostname
href
pathname
port
protocol
search
reload()
replace()

Properties

You can display each property of the location object by using the script below. (Some of the properties might not display, depending upon the URL that is accessed.)

document.write("hash: "+location.hash+"<br>");
document.write("host: "+location.host+"<br>");
document.write("hostname: "
  +location.hostname+"<br>");
  // combine with line above
document.write("URL: "+location.href+"<br>");
document.write("pathname: "
  +location.pathname+"<br>");
  // combine with line above
document.write("port: "+location.port+"<br>");
document.write("protocol: "
  +location.protocol+"<br>");
  // combine with line above
document.write("search: "+location.search);

Click here to see the results of a revised version of the script above (a new window will open).


The majority of the properties provide information about the document's relation to the server it resides on. They are useful in extracting portions of the URL for use in scripts.

hash

This property is used to navigate to areas on a page designated with the anchor tag, <a name="Note2">...</a>. The links to these type of URLs produce a hash, i.e., <a href="#2">...</a>. (Since it won't look like a link to the browser, you might want to add a style element to it: style="cursor:pointer"). An example of its use would be:

<a onClick=location.hash="Note2"
  style="cursor:pointer">Update on Tech News</a>
   // combine the two lines above

host

This property returns the name of the host and the port, if included. It combines both the location.hostname and location.port properties. If there is no port number, only the name of the host is given, as in the location.hostname property. If there is a port, the property would return a result something like: www.domain.com:80; otherwise, it would just be the host name: www.domain.com. An example of its use would be:
document.write("host: "+location.host);

hostname

This property returns the name of the host, i.e. www.domain.com. An example of its use would be:

document.write("host: "+location.hostname);

href

This property contains the entire URL. It's used to load a URL into the browser window. An example of its use would be:

location.href="https://www.webreference.com/";

It can also be used to load a new document:

location.href="yourFileName.html"

You can also load other types of files directly:

<form>
<input type="button" name="Music" value="Play Music"
onClick="location.href='/sounds/demo.wav';">
</form>

[previous] [next]

Created: October 14, 2005

URL: