Propriedade location.href do Window

Definição e uso

location.href Define ou retorna o URL completo da página atual.

Exemplo

Exemplo 1

Obter o URL da página atual:

let url = location.href;

Experimente você mesmo

Exemplo 2

Definir o URL da página atual:

location.href = "";

Experimente você mesmo

Exemplo 3

Definir o valor href para apontar para um âncora na página:

location.href = "#top";

Experimente você mesmo

Exemplo 4

Definir o valor href para apontar para o endereço de e-mail (abrirá o software e criará um novo e-mail):

location.href = "mailto:someone@example.com";

Experimente você mesmo

Sintaxe

Retornar o atributo href:

location.href

Definir o atributo href:

location.href = URL

Valor do atributo

Valor Descrição
URL

URL absoluta, por exemplo:

http://www.example.com/index.html


URL relativa, por exemplo:

index.html


URL de âncora, como:

location.href="#top"


Novo protocolo, como:

ftp://someftpserver.com

mailto:someone@example.com

file://host/path/example.txt

Valor retornado

Tipo Descrição
String URL completo da página, incluindo o protocolo (como https://).

Suporte do navegador

Todos os navegadores suportam location.href:

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Suporte Suporte Suporte Suporte Suporte Suporte