Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Location.href — ler o endereço e navegar

Location.href disponibiliza o URL do documento como uma cadeia de caracteres. Atribuir-lhe um valor inicia uma navegação, em vez de apenas alterar uma variável comum.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

window.location.href
window.location.href = url

Location.href é uma propriedade da API do navegador, acessível através de window.location.href. A sua leitura devolve o URL serializado do documento, incluindo a consulta e o fragmento, se existirem.

Atribuir window.location.href = url inicia uma navegação. Na atribuição, um endereço relativo é resolvido em relação ao URL base da API do objeto de configurações de entrada (entry settings object). Numa chamada síncrona entre frames, pode ser usado o URL base do frame que iniciou a chamada, em vez do URL base do frame cujo código efetua a atribuição. Um endereço inválido pode causar uma DOMException do tipo SyntaxError.

A leitura do endereço de outra janela está sujeita a restrições de origem e pode causar um SecurityError. O exemplo limita-se a ler o endereço; não sai da página.

Exemplos

const href = window.location.href;
console.log(typeof href);
console.log(href === window.location.toString());

Resultado

string
true

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes