Location

```
public interface Location
```

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`void`	`assign(java.lang.String url)` The assign() method loads a new document. The difference between this method and replace(), is that replace() removes the URL of the current document from the document history, meaning that it is not possible to use the "back" button to navigate back to the original document.
`java.lang.String`	`getHash()` The hash property returns the anchor part of a URL, including the hash sign (#).
`java.lang.String`	`getHost()` The host property returns the hostname and port of a URL.
`java.lang.String`	`getHostname()` The hostname property sets the hostname of a URL.
`java.lang.String`	`getHref()` The href property returns the entire URL of the current page.
`java.lang.String`	`getPathname()` The pathname property returns the pathname of a URL.
`java.lang.String`	`getPort()` The port property returns the port number the server uses for a URL. Note: If the port number is not specified in the URL (or if it is the scheme's default port - like 80, or 443), some browsers will display 0 or nothing.
`java.lang.String`	`getProtocol()` The protocol property returns the protocol of the current URL, including the colon (:).
`java.lang.String`	`getSearch()` The search property returns the querystring part of a URL, including the question mark (?).
`void`	`reload()` The reload() method is used to reload the current document. The reload() method does the same as the reload button in your browser. By default, the reload() method reloads the page from the cache, but you can force it to reload the page from the server by setting the forceGet parameter to true: location.reload(true).
`void`	`reload(boolean forceGet)` The reload() method is used to reload the current document. The reload() method does the same as the reload button in your browser. By default, the reload() method reloads the page from the cache, but you can force it to reload the page from the server by setting the forceGet parameter to true: location.reload(true).
`void`	`replace(java.lang.String url)` The replace() method replaces the current document with a new one. The difference between this method and assign(), is that replace() removes the URL of the current document from the document history, meaning that it is not possible to use the "back" button to navigate back to the original document. Tip: Use the assign() method if you want to load a new document, and the option to navigate back to the original document.
`void`	`setHash(java.lang.String anchorname)` The hash property sets the anchor part of a URL, including the hash sign (#).
`void`	`setHost(java.lang.String host)` The host property sets the hostname and port of a URL.
`void`	`setHostname(java.lang.String hostname)` The hostname property sets the hostname of a URL.
`void`	`setHref(java.lang.String href)` The href property sets the entire URL of the current page.
`void`	`setPathname(java.lang.String pathname)` The pathname property sets the pathname of a URL.
`void`	`setPort(java.lang.String port)` The port property sets the port number the server uses for a URL.
`void`	`setProtocol(java.lang.String protocol)` The protocol property sets the protocol of the current URL, including the colon (:).
`void`	`setSearch(java.lang.String search)` The search property sets the querystring part of a URL, including the question mark (?).

- Method Detail
  - getHash
```
java.lang.String getHash()
```
    The hash property returns the anchor part of a URL, including the hash sign (#).
    
    Returns:
    
    A String, representing the anchor part of the URL, including the hash sign (#)
  - setHash
```
void setHash(java.lang.String anchorname)
```
    The hash property sets the anchor part of a URL, including the hash sign (#).
    
    Parameters:
    
    anchorname - Specifies the anchor part of a URL
  - getHost
```
java.lang.String getHost()
```
    The host property returns the hostname and port of a URL.
    
    Returns:
    
    A String, representing the domain name and port number, or the IP address of a URL
  - setHost
```
void setHost(java.lang.String host)
```
    The host property sets the hostname and port of a URL.
    
    Parameters:
    
    host - Specifies the hostname and port number of the URL
  - getHostname
```
java.lang.String getHostname()
```
    The hostname property sets the hostname of a URL.
    
    Returns:
    
    A String, representing the domain name, or the IP address of a URL
  - setHostname
```
void setHostname(java.lang.String hostname)
```
    The hostname property sets the hostname of a URL.
    
    Parameters:
    
    hostname - Specifies the hostname of the URL
  - getHref
```
java.lang.String getHref()
```
    The href property returns the entire URL of the current page.
    
    Returns:
    
    A String, representing the entire URL of the page, including the protocol (like http://)
  - setHref
```
void setHref(java.lang.String href)
```
    The href property sets the entire URL of the current page.
    Parameters:
    href - 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")
  - getPathname
```
java.lang.String getPathname()
```
    The pathname property returns the pathname of a URL.
    
    Returns:
    
    A String, representing the pathname
  - setPathname
```
void setPathname(java.lang.String pathname)
```
    The pathname property sets the pathname of a URL.
    
    Parameters:
    
    pathname - Specifies the pathname of the URL
  - getPort
```
java.lang.String getPort()
```
    The port property returns the port number the server uses for a URL.
    Note: If the port number is not specified in the URL (or if it is the scheme's default port - like 80, or 443), some browsers will display 0 or nothing.
    
    Returns:
    
    A String, representing the port number of a URL.
  - setPort
```
void setPort(java.lang.String port)
```
    The port property sets the port number the server uses for a URL.
    
    Parameters:
    
    port - Specifies the port number of the URL
  - getProtocol
```
java.lang.String getProtocol()
```
    The protocol property returns the protocol of the current URL, including the colon (:).
    
    Returns:
    
    A String, representing the protocol of the current URL, including the colon (:)
  - setProtocol
```
void setProtocol(java.lang.String protocol)
```
    The protocol property sets the protocol of the current URL, including the colon (:).
    Parameters:
    protocol - The protocol of the URL. Possible values:
    
    file:
    http:
    https:
    mailto:
    etc...
  - getSearch
```
java.lang.String getSearch()
```
    The search property returns the querystring part of a URL, including the question mark (?).
    
    Returns:
    
    A String, representing the querystring part of a URL, including the question mark (?)
  - setSearch
```
void setSearch(java.lang.String search)
```
    The search property sets the querystring part of a URL, including the question mark (?).
    
    Parameters:
    
    search - Specifies the search part of the URL
  - assign
```
void assign(java.lang.String url)
```
    The assign() method loads a new document.
    The difference between this method and replace(), is that replace() removes the URL of the current document from the document history, meaning that it is not possible to use the "back" button to navigate back to the original document.
    
    Parameters:
    
    url - Required. Specifies the URL of the page to navigate to
  - reload
```
void reload()
```
    The reload() method is used to reload the current document.
    The reload() method does the same as the reload button in your browser.
    By default, the reload() method reloads the page from the cache, but you can force it to reload the page from the server by setting the forceGet parameter to true: location.reload(true).
  - reload
```
void reload(boolean forceGet)
```
    The reload() method is used to reload the current document.
    The reload() method does the same as the reload button in your browser.
    By default, the reload() method reloads the page from the cache, but you can force it to reload the page from the server by setting the forceGet parameter to true: location.reload(true).
    
    Parameters:
    
    forceGet - Optional. Specifies the type of reloading:
    false - Default. Reloads the current page from the cache.
    true - Reloads the current page from the server
  - replace
```
void replace(java.lang.String url)
```
    The replace() method replaces the current document with a new one.
    
    The difference between this method and assign(), is that replace() removes the URL of the current document from the document history, meaning that it is not possible to use the "back" button to navigate back to the original document.
    
    Tip: Use the assign() method if you want to load a new document, and the option to navigate back to the original document.
    
    Parameters:
    
    url - Required. Specifies the URL of the page to navigate to

Interface Location

Method Summary

Method Detail

getHash

setHash

getHost

setHost

getHostname

setHostname

getHref

setHref

getPathname

setPathname

getPort

setPort

getProtocol

setProtocol

getSearch

setSearch

assign

reload

reload

replace