Objeto Location do Window

Objeto Location do Window

O objeto Location contém informações sobre a URL atual.

O objeto Location é uma propriedade do objeto janela.

O objeto Location pode ser acessado da seguinte forma:

window.location ou apenas location

Exemplo

let origin = window.location.origin;

Experimente você mesmo!

let origin = location.origin;

Experimente você mesmo!

Atributos do objeto Location

Atributo Descrição
hash Definir ou retornar a parte de âncora da URL (#).
host Definir ou retornar o nome do host e o número da porta da URL.
hostname Definir ou retornar o nome do host da URL.
href Definir ou retornar a URL completa.
origin Retornar o protocolo, o nome do host e o número da porta da URL.
pathname Definir ou retornar o nome do caminho da URL.
port Definir ou retornar o número da porta da URL.
protocol Definir ou retornar o protocolo da URL.
search Definir ou retornar a parte da consulta da URL.

Métodos do objeto Location

Método 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 naquele navegador. Sua propriedade hrefArmazena a URL completa do documento, enquanto outras propriedades descrevem as várias partes da URL. Essas propriedades são muito semelhantes às propriedades URL do objeto Anchor (ou Area). Quando um objeto Location é convertido em uma string, o valor da propriedade href é retornado. Isso significa que você pode usar a expressão location para substituir location.href.

No entanto, o objeto Anchor representa um 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 apontado 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, atribuindo apenas 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, supondo que configurado o objeto Location propriedade hashEntão, o navegador se transferirá para uma posição específica no documento atual. Além disso, se configurado 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()Pode recarregar o documento atualreplace() Pode carregar um novo documento sem criar um novo registro de histórico, o que significa que o novo documento substituirá o documento atual na lista de histórico do navegador.