Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Location.href — leggere l’indirizzo e navigare

Location.href espone l’URL del documento come stringa. Assegnare un valore avvia una navigazione, invece di limitarsi a modificare una normale variabile.

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.href
window.location.href = url

Location.href è una proprietà dell’API del browser, accessibile tramite window.location.href. La lettura restituisce l’URL serializzato del documento, inclusi la query e il frammento, se presenti.

L’assegnazione window.location.href = url avvia una navigazione. Durante l’assegnazione, un indirizzo relativo viene risolto rispetto all’URL di base dell’API dell’oggetto delle impostazioni di ingresso (entry settings object). In una chiamata sincrona tra frame, può trattarsi dell’URL di base del frame che ha avviato la chiamata anziché di quello del frame il cui codice esegue l’assegnazione. Un indirizzo non valido può generare una DOMException di tipo SyntaxError.

La lettura dell’indirizzo di un’altra finestra è soggetta a restrizioni sull’origine e può generare un SecurityError. L’esempio legge soltanto l’indirizzo; non abbandona la pagina.

Esempi

const href = window.location.href;
console.log(typeof href);
console.log(href === window.location.toString());

Risultato

string
true

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