CKTIS / JavaScript
URL.hash — o fragmento do URL
URL.hash lê e define o fragmento de um URL. Saiba como funciona a codificação e qual a diferença entre um fragmento vazio e um fragmento ausente.
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
url.hash
url.hash = fragmentURL.hash é uma propriedade de instância gravável de URL, não um método estático. Devolve o fragmento com um # inicial ou "" quando o fragmento está vazio ou ausente.
A atribuição aceita texto com ou sem um # inicial. Os caracteres que o exigem são codificados em percentagem; a leitura não os descodifica. Um espaço passa a %20.
url.hash = '' remove o fragmento. url.hash = '#' mantém um fragmento vazio: url.hash continua a devolver "", mas url.href termina em #. Esta é uma Web API do WHATWG URL Standard, não uma funcionalidade definida pelo ECMAScript.
Exemplos
const url = new URL('https://example.org/');
url.hash = 'part one';
console.log(url.hash);
url.hash = '#';
console.log(JSON.stringify(url.hash), url.href);
url.hash = '';
console.log(url.href);Resultado
#part%20one "" https://example.org/# https://example.org/
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.