Location : Object

Location describes the url of the current page. It is available through the window.location property. See also History.

Here's an example:

Property	Value
`href`	`'http://username:[email protected]:80/pathname?search=terms#hash'`
`protocol`	`'http:'`
`username`	`'username'`
`password`	`'password'`
`hostname`	`'www.javascripture.com'`
`port`	`'80'`
`host`	`'www.javascripture.com:80'`
`origin`	`'http://www.javascripture.com:80'`
`pathname`	`'/pathname'`
`search`	`'?search=terms'`
`hash`	`'#hash'`

Spec

Instance Properties

hash : String

The hash portion of Location. This is the '#' and everything following it. Use the window.onhashchange event to listen for changes to the hash.

Example:

<a id='foo' href='#bar'>Go to #bar</a>
<div style='height: 1000px'></div>
<a id='bar' href='#foo'>Go to #foo</a>

<script>
  var printHash = function() {
    console.log("'" + window.location.hash + "'");
  };

  // Print initial hash
  printHash();

  window.onhashchange = printHash;
</script>

Run

Results:

Spec

host : String

The host of the current Location. Composed of hostname and port (if any).

Example:

<script>
  console.log(window.location.host);
</script>

Run

Results:

Spec

hostname : String

The hostname of the current Location.

Example:

<script>
  console.log(window.location.hostname);
</script>

Run

Results:

Spec

href : String

The concatenation of all parts of the Location into one string. You can set href to cause the browser to navigate to a new location.

Example:

<button onclick='goHome()'>Go Home</button>
<script>
  console.log('current href: ' + window.location.href);

  var goHome = function() {
    window.location.href = 'http://www.javascripture.com/';
  };
</script>

Run

Results:

Spec

origin : String readonly

The origin of the current Location. Composed of the protocol, hostname, and port (if any).

Example:

<script>
  console.log(window.location.origin);
</script>

Run

Results:

Spec

password : String

The password of Location or undefined if not specified.

Example:

<script>
  console.log(window.location.password);
</script>

Run

Results:

Spec

pathname : String

The path of Location.

Example:

<script>
  console.log(window.location.pathname);
</script>

Run

Results:

Spec

port : String

The port of the current Location. May be '' if the port is the not specified in the Location.

Example:

<script>
  console.log("'" + window.location.port + "'");
</script>

Run

Results:

Spec

protocol : String

The protocol of the current Location.

Example:

<script>
  console.log(window.location.protocol);
</script>

Run

Results:

Spec

search : String

The search portion of Location. This is the '?' and everything following it.

Example:

<script>
  console.log("'" + window.location.search + "'");
</script>

Run

Results:

Spec

username : String

The username of Location or undefined if not specified.

Example:

<script>
  console.log(window.location.username);
</script>

Run

Results:

Spec

Instance Methods

assign(url : String) : undefined

Navigates to the specified url. The current page is stored in the browser's navigation stack.

reload() : undefined

Reloads the current page.

replace(url : String) : undefined

Navigates to the specified url. The current page is removed from the browser's navigation stack.

home license contribute feedback toggle light/dark mode