O objeto Location

Objeto Location 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 hrefArmazenada é a URL completa do documento, enquanto outras propriedades descrevem 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 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 uma hiperligação 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 ao qual a nova URL se refere.

Além de substituir a URL atual com um URL completo 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 dela diferente da URL original, e o navegador carregará e exibirá. Por exemplo, supondo que o objeto Location propriedade hashEntão, o navegador será transferido 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()Pode recarregar o documento atualreplace() Pode carregar um novo documento sem criar um novo registro de histórico, isso é, o novo documento substituirá o documento atual na lista de histórico do navegador.