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

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 = fragment

URL.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.

Fontes