Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Location: frammento, origine, percorso, query e URL completo

Leggi le cinque proprietà dell’URL di un documento e distingui le assegnazioni che possono avviare una navigazione.

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

Sintassi

const loc = window.location;
loc.hash;      // string: fragment
loc.origin;    // string: URL origin (read-only)
loc.pathname;  // string: path
loc.search;    // string: query
loc.href;      // string: complete URL

// Assignments on a live Location can initiate navigation:
loc.hash = "intro";
loc.pathname = "/guide";
loc.search = "?mode=demo";
loc.href = "/guide?mode=demo#intro";

window.location restituisce l’oggetto Location associato al documento. È un’API Web del browser, non una parte di ECMAScript 2024. L’oggetto riflette l’URL corrente del documento, ma una stringa letta in precedenza non si aggiorna. Usa new URL(window.location.href) per esaminare o modificare un URL separato senza avviare una navigazione.

href è l’URL completo serializzato. pathname contiene solo il percorso, senza query né frammento. Con HTTP(S) inizia con /, anche alla radice; un percorso opaco come blank in about:blank può non avere una barra iniziale. search restituisce una query non vuota con ?, mentre hash restituisce un frammento non vuoto con #. Se il relativo componente è assente o vuoto, il risultato è "", anche se il delimitatore compare ancora in href. La lettura non decodifica le sequenze codificate con %. Usa new URLSearchParams(window.location.search) per leggere i singoli parametri della query.

origin è di sola lettura e descrive l’origine dell’URL. Per HTTP(S) include schema e nome host, oltre alla porta se non è quella predefinita. Un’origine opaca dell’URL si serializza nella stringa "null", non nel valore null. self.origin descrive invece l’origine dell’ambiente di esecuzione: un documento about:blank può ereditarla. Due stringhe "null" non dimostrano che le origini coincidano.

Assegnare un valore a href può avviare una navigazione verso un altro URL, anche relativo. Se l’analisi dell’URL fallisce, viene generata una DOMException chiamata SyntaxError. Assegnare un valore a pathname o search può avviare una navigazione con percorso o query modificati. L’assegnazione a pathname non ha effetto su un percorso opaco. In scrittura, i prefissi ? e # sono facoltativi rispettivamente per search e hash. search = "" rimuove la query, ma hash = "" può lasciare un # finale. Modificare solo il frammento di norma non carica un nuovo documento.

Leggere una di queste cinque proprietà in una finestra di origine diversa può generare una DOMException chiamata SecurityError. Scrivere in href è un’eccezione: può essere consentito anche senza accesso in lettura, ma si applicano comunque le restrizioni del browser sulla navigazione.

Esempi

const { hash, origin, pathname, search, href } = new URL("about:blank?mode=demo#intro");
console.log(JSON.stringify({ hash, origin, pathname, search, href }));

Risultato

{"hash":"#intro","origin":"null","pathname":"blank","search":"?mode=demo","href":"about:blank?mode=demo#intro"}

Esegui il codice in Node.js. Legge gli stessi componenti dell’URL da un oggetto `URL` anziché da un oggetto `Location` del browser, senza avviare una navigazione. Nel risultato, `"null"` è una stringa e `blank` non inizia con `/`.

Lezioni correlate

  • JavaScript · Lezione 38 · Avanzato · Versione: 4

Fonti