JavaScript » Objects » Location

The Location object is part of a Window object and is accessed through the window.location property. It contains the complete URL of a given Window object, or, if none is specified, of the current Window object.

All of its properties are strings representing different portions of the URL, which generally takes the following form:

<protocol>//<host>[:<port>]/<pathname>[<hash>][<search>]
 

Examples

Code:
window.location = "file:///C:/Projects"
Explanation:

You can create a Location object by simply assigning a URL to the location property of an object.

Properties

hash

Syntax: location.hash

The hash property is a string beginning with a hash (#), that specifies an anchor name in an HTTP URL.

host

Syntax: location.host

The host property is a string comprising of the hostname and port strings.

hostname

Syntax: location.hostname

The hostname property specifies the server name, subdomain and domain name (or IP address) of a URL.

href

Syntax: location.href

The href property is a string specifying the entire URL, and of which all other Link properties are substrings.

pathname

Syntax: location.pathname

The pathname property is a string portion of a URL specifying how a particular resource can be accessed.

port

Syntax: location.port

The port property is a string specifying the communications port that the server uses.

protocol

Syntax: location.protocol

The protocol property is the string at the beginning of a URL, up to and including the first colon (:), which specifies the method of access to the URL.

search

Syntax: location.search

The search property is a string beginning with a question mark that specifies any query information in an HTTP URL.

Methods

reload

Syntax: Location.reload([forceGet])

The reload method forces a reload of the window's current document, i.e. the one contained in the Location.href property.

replace

Syntax: location.replace(URL)

The replace method replaces the current History entry with the specified URL. After calling the replace method, you cannot navigate back to the previous URL using the browser's Back button.

See Also: