Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Componenti dell’URL della pagina: origin, pathname, search, hash e href

L’oggetto window.location espone l’URL completo della pagina corrente e i suoi componenti. Scopri le differenze tra origin, pathname, search, hash e href e perché scrivere in Location può avviare una navigazione.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

window.location.origin
window.location.pathname
window.location.search
window.location.hash
window.location.href

window.location è un oggetto Location associato al documento corrente; è accessibile anche come document.location. Le sue proprietà descrivono l’URL della pagina e restituiscono stringhe. È una Web API del browser, non una funzionalità di ECMAScript in sé. La presenza di Node 24 in un repository non dimostra il supporto per il Location del browser.

Location.origin è di sola lettura. Per HTTP(S), contiene lo schema, //, il nome host e la porta se non è quella predefinita; non include il percorso. Per file:, il risultato dipende dal browser, quindi non estendere le regole HTTP(S) a tutti gli schemi. Location.pathname contiene il percorso senza la query né il frammento; per HTTP(S), inizia con /.

Location.search restituisce la query, se non è vuota, con il ? iniziale. Se la query è assente o vuota, restituisce "", anche quando l’URL termina con un ? non seguito da altri caratteri. La lettura non decodifica le sequenze percentuali: %20 rimane %20. Usa new URLSearchParams(window.location.search) per leggere i singoli parametri. Location.hash restituisce il frammento, se non è vuoto, con il # iniziale. Se il frammento è assente o vuoto, restituisce "", anche quando l’URL termina con un # non seguito da altri caratteri. Location.href restituisce l’intero URL, inclusi query e frammento.

Leggere queste proprietà non modifica la pagina, ma scrivere in href avvia una navigazione. Modificare pathname o search può caricare a sua volta un documento; modificare solo hash di solito significa navigare all’interno dello stesso documento. Per esaminare in sicurezza un indirizzo qualsiasi, usa URL invece di modificare window.location. L’esempio usa un oggetto URL separato con nomi di proprietà corrispondenti: il risultato è fisso e la pagina non viene reindirizzata. Non è una verifica del comportamento di navigazione di Location.

Esempi

const url = new URL("https://example.org:8443/docs/start?q=web%20api#intro");
for (const key of ["origin", "pathname", "search", "hash", "href"]) {
  console.log(`${key}: ${url[key]}`);
}

Risultato

origin: https://example.org:8443
pathname: /docs/start
search: ?q=web%20api
hash: #intro
href: https://example.org:8443/docs/start?q=web%20api#intro

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti