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

Levar o usuário a um novo endereço

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.