Name

Location — represents and controls browser location

Availability

JavaScript 1.0; enhanced in JavaScript 1.1

Synopsis

location window.location

Properties

The properties of a Location object refer to the various portions of the current document’s URL. In each of the following property descriptions, the example given is a portion of this (fictitious) URL:

http://www.oreilly.com:1234/catalog/search.html?q=JavaScript&m=10#results
hash

A read/write string property that specifies the anchor portion of the URL, including the leading hash (#) mark. For example: “#result”. This portion of the document URL specifies the name of an anchor within the document.

host

A read/write string property that specifies the hostname and port portions of the URL. For example, “www.oreilly.com:1234”.

hostname

A read/write string property that specifies the hostname portion of a URL. For example “www.oreilly.com”.

href

A read/write string property that specifies the complete text of the document’s URL, unlike other Location properties which specify only portions of the URL. Setting this property to a new URL causes the browser to read and display the contents of the new URL.

pathname

A read/write string property that specifies the pathname portion of a URL. For example “/catalog/search.html”.

port

A read/write string (not a number) property that specifies the port portion of a URL. For example “1234”.

protocol

A read/write string property that specifies the protocol portion of a URL, including ...

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

O’Reilly members experience live online training, plus books, videos, and digital content from 200+ publishers.