Location
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
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
Specification |
---|
HTML Standard # the-location-interface |
Compatibilidade com navegadores
BCD tables only load in the browser
Veja também
- Dois métodos que criam um objeto Location:
Window.location
eDocument.location
.