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

Especificação Status Comentário
WHATWG HTML Living Standard
The definition of 'Location' in that specification.
Living Standard Nenhuma mudança a partir HTML5.
HTML5
The definition of 'Location' in that specification.
Recommendation Definição inicial.

Compatibilidade entre Navegadores

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) ? 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) ? 26.0 (26) ? ? ?
username e password ? 26.0 (26) ? ? ?

Veja também

Etiquetas do documento e colaboradores

Etiquetas: 
 Colaboradores desta página: trGalho
 Última atualização por: trGalho,