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 (en-US), 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() (en-US)
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

Especificação Status Comentário
HTML Living Standard
The definition of 'Location' in that specification.
Padrão em tempo real Nenhuma mudança a partir HTML5.
HTML5
The definition of 'Location' in that specification.
Recomendação Definição inicial.

Compatibilidade entre Navegadores

Estamos convertendo nossos dados de compatibilidade para o formato JSON. Esta tabela de compatibilidade ainda usa o formato antigo, pois ainda não convertemos os dados que ela contém. Descubra como você pode ajudar! (en-US)

Funcionalidade Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Suporte Básico (Yes) (Yes) (Yes) (Yes) (Yes)
origin em Windows.location ? 21 (21) ? ? ?
origin em todos objetos location (mas nos objetos Workers, que usam WorkerLocation (en-US)) ? 26 (26) ? ? ?
username e password ? 26 (26) ? ? ?
Funcionalidade Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Suporte Básico (Yes) (Yes) (Yes) (Yes) (Yes)
origin on Windows.location ? 21.0 (21) ? ? ?
origin on all location objects (mas nos objetos Workers, que usam WorkerLocation (en-US)) ? 26.0 (26) ? ? ?
username e password ? 26.0 (26) ? ? ?

Veja também