Objeto Localização
Objeto Localização
O objeto Location contém informações sobre a URL atual.
O objeto Location é uma parte do objeto Window, que pode ser acessado através da propriedade window.location.
exemplo
propriedades do objeto Location
propriedade | descrição |
---|---|
hash | Definir ou retornar a parte da URL a partir do caractere de número (#). |
host | Definir ou retornar o nome do host e o número da porta da URL atual. |
hostname | Definir ou retornar o nome do host da URL atual. |
href | Definir ou retornar o URL completo. |
pathname | Definir ou retornar a parte do caminho da URL atual. |
port | Definir ou retornar o número da porta da URL atual. |
protocol | Definir ou retornar o protocolo da URL atual. |
search | Definir ou retornar a parte da URL a partir do caractere de interrogação (?). |
métodos do objeto Location
propriedade | descrição |
---|---|
assign() | Carregar um novo documento. |
reload() | Recarregar o documento atual. |
replace() | Substitua o documento atual por um novo documento. |
descrição do objeto Location
O objeto Location é armazenado na propriedade Location do objeto Window, representando o endereço da Web do documento atualmente exibido na janela. Sua propriedade hrefArmazenado é o URL completo do documento, outras propriedades descrevem respectivamente as partes da URL. Essas propriedades são muito semelhantes às propriedades URL do objeto Anchor (ou objeto Area). Quando um objeto Location é convertido em string, é retornado o valor da propriedade href. Isso significa que você pode usar a expressão location para substituir location.href.
No entanto, o objeto Anchor representa o link de hipertexto no documento, enquanto o objeto Location representa a URL (ou posição) do documento atualmente exibido no navegador. No entanto, o objeto Location pode fazer muito mais do que isso, ele também pode controlar a posição do documento exibido pelo navegador. Se uma string contendo uma URL for atribuída ao objeto Location ou a sua propriedade href, o navegador carregará e exibirá o documento referenciado pela nova URL.
Além de substituir a URL atual com uma URL completa usando location ou location.href, também é possível modificar parte da URL, apenas atribuindo outros atributos ao objeto Location. Isso criará uma nova URL, parte da qual será diferente da URL original, e o navegador carregará e exibirá. Por exemplo, se o objeto Location propriedade hashentão o navegador se transferirá para uma posição específica no documento atual. Da mesma forma, se definido propriedade searchentão o navegador recarregará a URL com a nova string de consulta anexada.
Além da propriedade URL, o objeto Location Método reload()É possível recarregar o documento atualreplace() É possível carregar um novo documento sem criar um novo histórico, o que significa que no histórico do navegador, o novo documento substituirá o documento atual.