CKTIS / JavaScript
Location.hash e Location.href: fragmento ou URL completo
`Location.hash` lê ou altera o fragmento do URL. `Location.href` devolve o URL completo ou pede a navegação para um destino.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
const fragment = window.location.hash;
const currentURL = window.location.href;
window.location.hash = fragmentString;
window.location.href = destinationURL;window.location dá acesso ao objeto Location associado ao documento. É uma API do navegador definida pelo padrão HTML, não pelo ECMAScript 2024. Não pressuponhas que existe fora do contexto de uma janela do navegador.
Ao ler hash, obténs um fragmento não vazio precedido de #, sem descodificar as sequências de codificação percentual. Se o fragmento estiver ausente ou vazio, o valor é "". href devolve o URL completo como cadeia de caracteres, incluindo a consulta e o fragmento, se existirem. Pode haver um # no fim de href mesmo quando hash é "".
Atribuir um valor a hash altera apenas o fragmento; o # inicial é opcional. Se o fragmento resultante se mantiver igual, não há navegação. Atribuir "" define um fragmento vazio em vez de o remover. Se a navegação no mesmo documento alterar o fragmento, ocorre o evento hashchange sem recarregar o documento.
Atribuir um valor a href indica um destino de navegação. Um URL relativo é resolvido em relação ao URL de base do ambiente que efetua a atribuição. Se o URL não puder ser analisado, o navegador lança uma DOMException com o nome SyntaxError. As regras de origem limitam a leitura de ambas as propriedades e a escrita em hash. A escrita em href pode ser permitida entre origens diferentes, mas continua sujeita a restrições de navegação.
Exemplos
(async () => {
const show = address => console.log(JSON.stringify([address.hash, address.href]));
if (typeof document === 'undefined') {
// Node.js: URL serialization only, without navigation or hashchange.
const url = new URL('about:blank');
show(url);
url.hash = 'details';
show(url);
url.href = 'about:blank#summary';
show(url);
return;
}
const frame = document.createElement('iframe');
frame.hidden = true;
document.body.append(frame);
try {
const child = frame.contentWindow;
const location = child.location;
const nextHashChange = () => new Promise(resolve => {
child.addEventListener('hashchange', resolve, { once: true });
});
show(location);
const firstChange = nextHashChange();
location.hash = 'details';
await firstChange;
show(location);
const secondChange = nextHashChange();
location.href = 'about:blank#summary';
await secondChange;
show(location);
} finally {
frame.remove();
}
})();Resultado
["","about:blank"] ["#details","about:blank#details"] ["#summary","about:blank#summary"]
Executa o código na consola de uma página HTTP(S) normal, totalmente carregada, que permita um iframe sem restrições de `sandbox`. Cada linha mostra `[hash, href]`. Ambas as atribuições alteram o URL do iframe, não o da página que o contém. Em Node.js, o exemplo usa um objeto `URL` em vez de `Location` para mostrar apenas a serialização do URL, sem navegação nem eventos `hashchange`.
Lições relacionadas
- JavaScript · Lição 30 · Avançado · Versão: 4