Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Location.hash e Location.href: frammento o URL completo

`Location.hash` legge o modifica il frammento dell’URL. `Location.href` restituisce l’URL completo o richiede di navigare verso una destinazione.

Versione: ECMAScript 2024 and the current web platform; runtime support varies

Sintassi

const fragment = window.location.hash;
const currentURL = window.location.href;
window.location.hash = fragmentString;
window.location.href = destinationURL;

window.location espone l’oggetto Location associato al documento. È un’API del browser definita dallo standard HTML, non da ECMAScript 2024. Non dare per scontato che esista al di fuori del contesto di una finestra del browser.

In lettura, hash restituisce un frammento non vuoto preceduto da #, senza decodificare le sequenze percentuali. Se il frammento è assente o vuoto, restituisce "". href restituisce l’intero URL come stringa, inclusi la query e il frammento se presenti. Un # finale può comparire in href anche quando hash vale "".

Assegnare un valore a hash modifica solo il frammento; il # iniziale è facoltativo. Se il frammento risultante non cambia, non c’è navigazione. Assegnare "" imposta un frammento vuoto anziché rimuoverlo. Una modifica del frammento tramite navigazione nello stesso documento genera hashchange senza ricaricarlo.

Assegnare un valore a href indica una destinazione di navigazione. Un URL relativo viene risolto rispetto all’URL di base dell’ambiente che esegue l’assegnazione. Se l’analisi fallisce, il browser lancia una DOMException denominata SyntaxError. Le regole sull’origine limitano la lettura di entrambe le proprietà e la scrittura di hash. Scrivere href può essere consentito tra origini diverse, ma restano valide le restrizioni di navigazione.

Esempi

(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();
  }
})();

Risultato

["","about:blank"]
["#details","about:blank#details"]
["#summary","about:blank#summary"]

Esegui il codice nella console di una normale pagina HTTP(S), completamente caricata, che consenta un iframe senza restrizioni `sandbox`. Ogni riga mostra `[hash, href]`. Entrambe le assegnazioni cambiano l’URL dell’iframe, non quello della pagina che lo contiene. In Node.js l’esempio usa un oggetto `URL` al posto di `Location` per mostrare solo la serializzazione dell’URL, senza navigazione né eventi `hashchange`.

Lezioni correlate

  • JavaScript · Lezione 30 · Avanzato · Versione: 4

Fonti