CKTIS / JavaScript
URL — analizzare e modificare gli indirizzi
URL scompone un indirizzo nei suoi componenti, risolve riferimenti relativi e consente di modificare i parametri di query.
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
new URL(url, base?)URL è un’API WHATWG, non ECMAScript. new URL(url, base?) analizza un indirizzo; i riferimenti relativi richiedono una base. Se l’analisi non riesce, viene generato un TypeError.
href espone l’indirizzo serializzato completo, mentre pathname ne espone il percorso. Per HTTP(S), origin contiene lo schema, l’host e l’eventuale porta, ma non il percorso. La risoluzione rispetto a una base non è una concatenazione: lo / finale è importante.
searchParams è un oggetto URLSearchParams collegato: le sue modifiche aggiornano l’indirizzo. Passa i valori senza codificarli in precedenza; gli spazi vengono serializzati come +. Un’analisi riuscita non dimostra che l’indirizzo sia sicuro: verifica che protocol e origin siano consentiti.
Esempi
const url = new URL("../items", "https://example.com/app/docs/");
url.searchParams.set("q", "red shoes");
console.log(url.pathname);
console.log(url.href);Risultato
/app/items https://example.com/app/items?q=red+shoes
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.