Location
Baseline
Widely available
*
This feature is well established and works across many devices and browser versions. It’s been available across browsers since julho de 2015.
* Some parts of this feature may have varying levels of support.
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
DOMStringque contém toda URL. URLUtils.protocol-
É uma
DOMStringque contém o esquema de protocolo da URL, incluindo o final ':'. URLUtils.host-
É uma
DOMStringque contém o host, que é o hostname seguido de ':' e a port da URL. URLUtils.hostname-
É uma
DOMStringque contém o domínio da URL. URLUtils.port-
É uma
DOMStringque contém o número da porta da URL. URLUtils.pathname-
É uma
DOMStringque contém'/', como caractere inicial, seguido do caminho da URL. URLUtils.search-
É uma
DOMStringque contém um'?'seguido dos parâmetros da URL. URLUtils.hash-
É uma
DOMStringque contém um'#'seguido do identificador de fragmento da URL. URLUtils.username-
É uma
DOMStringque contém o nome de usuário especificado antes do nome de domínio. URLUtils.password-
É uma
DOMStringque contém a senha especificada antes do nome de domínio. URLUtils.originSomente leitura-
Retorna uma
DOMStringque 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
DOMStringque 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> # the-location-interface> |
Compatibilidade com navegadores
Loading…
Veja também
- Dois métodos que criam um objeto Location:
Window.locationeDocument.location.