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 usarreplace()
a página atual não será salva na sessãoHistory
, 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 paraURLUtils.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!
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
- Dois métodos que criam um objeto Location:
Window.location
eDocument.location
.