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

CKTIS / JavaScript

Componentes do URL da página: origin, pathname, search, hash e href

O objeto window.location expõe o URL completo da página atual e os respetivos componentes. Saiba em que diferem origin, pathname, search, hash e href, e porque escrever em Location pode iniciar uma navegação.

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.origin
window.location.pathname
window.location.search
window.location.hash
window.location.href

window.location é um objeto Location associado ao documento atual; também está disponível como document.location. As suas propriedades descrevem o URL da página e devolvem cadeias de caracteres. Trata-se de uma API Web do navegador, não de uma funcionalidade do próprio ECMAScript. A presença de Node 24 num repositório não comprova o suporte do Location do navegador.

Location.origin é só de leitura. Para HTTP(S), contém o esquema, //, o nome do anfitrião e a porta, se não for a predefinida; não inclui o caminho. Para file:, o resultado depende do navegador, por isso não generalize as regras de HTTP(S) a todos os esquemas. Location.pathname contém o caminho sem a consulta nem o fragmento; para HTTP(S), começa por /.

Location.search devolve a consulta, se não estiver vazia, com o ? inicial. Se a consulta não existir ou estiver vazia, devolve "", mesmo quando o URL termina com um ? sem conteúdo a seguir. A leitura não descodifica sequências percentuais: %20 mantém-se como %20. Use new URLSearchParams(window.location.search) para ler parâmetros individuais. Location.hash devolve o fragmento, se não estiver vazio, com o # inicial. Se o fragmento não existir ou estiver vazio, devolve "", mesmo quando o URL termina com um # sem conteúdo a seguir. Location.href devolve o URL completo, incluindo a consulta e o fragmento.

A leitura destas propriedades não altera a página, mas escrever em href inicia uma navegação. Alterar pathname ou search também pode carregar um documento; alterar apenas hash costuma significar uma navegação dentro do mesmo documento. Para examinar com segurança um endereço arbitrário, use URL em vez de modificar window.location. O exemplo utiliza um objeto URL separado com nomes de propriedades correspondentes: o resultado é fixo e a página não é redirecionada. Não é um teste do comportamento de navegação de Location.

Exemplos

const url = new URL("https://example.org:8443/docs/start?q=web%20api#intro");
for (const key of ["origin", "pathname", "search", "hash", "href"]) {
  console.log(`${key}: ${url[key]}`);
}

Resultado

origin: https://example.org:8443
pathname: /docs/start
search: ?q=web%20api
hash: #intro
href: https://example.org:8443/docs/start?q=web%20api#intro

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