X
HOME HTML CSS JAVASCRIPT SQL PHP JQUERY ANGULAR BOOTSTRAP XML ASP.NET MORE...
REFERENCES | EXAMPLES | FORUM | ABOUT

Location href Property

Location Object Reference Location Object

Example

Return the entire URL (of the current page):

var x = location.href;

The result of x will be:


Try it yourself »


Definition and Usage

The href property sets or returns the entire URL of the current page.


Browser Support

Property
href Yes Yes Yes Yes Yes


Syntax

Return the href property:

location.href

Set the href property:

location.href=URL

Parameter Values

Value Type Description
URL String Specifies the URL of the link.

Possible values:

  • An absolute URL - points to another web site (like location.href="http://www.example.com/default.htm")
  • A relative URL - points to a file within a web site (like location.href="default.htm")
  • An anchor URL - points to an anchor within a page (like location.href="#top")
  • A new protocol - specifies a different protocol (like location.href="ftp://someftpserver.com", location.href="mailto:someone@example.com" or location.href="file://host/path/example.txt")

Technical Details

Return Value: A String, representing the entire URL


Examples

More Examples

Example

Set the href value to point to another web site:

location.href = "http://www.cnn.com";

Try it yourself »

Example

Set the href value to point to an anchor within a page:

location.href = "#top";

Try it yourself »

Example

Set the href value to point to an email address (will open and create a new email message):

location.href = "mailto:someone@example.com";

Try it yourself »


Location Object Reference Location Object

Your suggestion:

Close [X]

Thank You For Helping Us!

Your message has been sent to W3Schools.

Close [X]
Search w3schools.com:

WEB HOSTING

UK Reseller Hosting

WEB BUILDING

Download XML Editor FREE Website BUILDER Free HTML5 Templates

SHARE THIS PAGE

facebook