Location

Resumo

A interface Location representa a localização do objeto a qual ele está associado. Mudanças feitas na interface serão refletidas nos objetos relacionados a ela. Tanto a interface Document, como a interface Window , têm este vínculo com a inteface Location, acessível via Document.location e Window.location respectivamente.

Propriedades

A inteface Location não herda nenhuma propriedade, mas implementa as propriedades de URLUtils.

URLUtils.href

É uma DOMString que contém toda URL.

URLUtils.protocol

É uma DOMString que contém o esquema de protocolo da URL, incluindo o final ':'.

URLUtils.host

É uma DOMString que contém o host, que é o hostname seguido de ':' e a port da URL.

URLUtils.hostname

É uma DOMString que contém o domínio da URL.

URLUtils.port

É uma DOMString que contém o número da porta da URL.

URLUtils.pathname

É uma DOMString que contém '/', como caractere inicial, seguido do caminho da URL.

URLUtils.search

É uma DOMString que contém um '?' seguido dos parâmetros da URL.

URLUtils.hash

É uma DOMString que contém um '#' seguido do identificador de fragmento da URL.

URLUtils.username

É uma DOMString que contém o nome de usuário especificado antes do nome de domínio.

URLUtils.password

É uma DOMString que contém a senha especificada antes do nome de domínio.

URLUtils.origin Somente leitura

Retorna uma DOMString que contém a forma canônica da origem do local especificado.

Métodos

A inteface Location não herda nenhum método, mas implementa os métodos de URLUtils.

Location.assign()

Carrega o recurso na URL fornecida como parâmetro.

Location.reload()

Recarrega o recurso a partir da URL atual. Seu único parâmetro opcional é um Boolean, que, quando verdadeiro (true), faz com que a página sempre seja recarregada a partir do servidor. Se for falso (false) ou não especificado,  o navegador pode recarregar a página a partir de seu cache.

Location.replace()

Substitui o recurso atual pelo recurso presente na URL fornecida. A diferença entre o método assign() é que após usar replace() a página atual não será salva na sessão  History, ou seja, o usuário não será capaz de usar o botão voltar para navegar até a página.

URLUtils.toString()

Retorna uma DOMString que contém toda URL. O método é um sinônimo para URLUtils.href, embora não possa ser usado para modificar o valor.

Especificações

Compatibilidade entre Navegadores

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Veja também

• Dois métodos que criam um objeto Location: Window.location e Document.location.