Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

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

Usa `hash` per leggere o modificare il frammento e `href` per leggere o sostituire l’intero URL. Leggere il solo `hash` non distingue un frammento vuoto da uno assente.

Versione: Current web platform; runtime support varies

Sintassi

const url = new URL(input, base); // Omit base for an absolute input.
url.hash;                        // Fragment string
url.hash = fragment;
url.href;                        // Full serialized URL
url.href = absoluteUrl;

hash e href sono proprietà di istanza di URL, non metodi né proprietà statiche. url.hash restituisce il frammento non vuoto con il # iniziale, oppure "" se il frammento è vuoto o assente. url.href restituisce l’intero URL serializzato, inclusa l’eventuale stringa di query. Un # finale in href permette di distinguere un frammento vuoto da uno assente.

Assegna a url.hash il testo del frammento con o senza # iniziale. Caratteri come gli spazi vengono codificati con la codifica percentuale quando necessario, ma non vengono decodificati automaticamente in lettura. url.hash = "" rimuove il frammento; url.hash = "#" lascia un frammento vuoto. Il frammento è distinto dalla query: url.searchParams gestisce i parametri della query e il frammento non viene inviato automaticamente al server in una richiesta HTTP.

L’assegnazione a url.href analizza il nuovo valore e sostituisce l’intero URL nello stesso oggetto. Se l’analisi fallisce, viene generato un TypeError. Il setter non risolve i riferimenti relativi rispetto all’URL corrente; per farlo, usa new URL(relative, base).href con una base valida.

Modificare un oggetto URL non avvia una navigazione, a differenza di un’assegnazione a window.location.href. Prima di navigare verso un URL non attendibile, verifica che lo schema e l’origine siano consentiti: un’analisi riuscita non rende sicuro l’URL. URL è un’API della piattaforma web, non fa parte di ECMAScript 2024; la sua disponibilità dipende dall’ambiente di esecuzione.

Esempi

{
  const url = new URL("https://example.com/guide?lang=en");
  const show = () => console.log(JSON.stringify([url.hash, url.href]));

  url.hash = "quick start";
  show();

  url.hash = "#";
  show();

  url.hash = "";
  show();

  url.href = "https://example.org/start#intro";
  show();
}

Risultato

["#quick%20start","https://example.com/guide?lang=en#quick%20start"]
["","https://example.com/guide?lang=en#"]
["","https://example.com/guide?lang=en"]
["#intro","https://example.org/start#intro"]

Ogni riga mostra `[hash, href]`. Nota `%20`, il `#` finale solo nella seconda riga e la sostituzione dell’intero URL nell’ultima.

Lezioni correlate

  • JavaScript · Lezione 30 · Avanzato · Versione: 4

Fonti