CKTIS / JavaScript
URL.searchParams — parametri di query
URL.searchParams espone i parametri di query come oggetto URLSearchParams collegato all’URL.
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
url.searchParamsURL.searchParams è una proprietà di un’istanza di URL, non un metodo statico. La proprietà è di sola lettura, ma l’oggetto URLSearchParams restituito è modificabile. Le modifiche aggiornano l’URL; le letture ripetute restituiscono lo stesso oggetto.
get() restituisce il primo valore oppure null; getAll() gestisce i nomi ripetuti. set() sostituisce i valori di un nome con un unico valore.
La serializzazione usa application/x-www-form-urlencoded: uno spazio diventa +. Si tratta di una Web API WHATWG, non di una funzionalità di un’edizione ECMAScript; la compatibilità dei browser va verificata separatamente.
Esempi
const url = new URL('https://example.com/?tag=js&tag=web');
const params = url.searchParams;
console.log(params.getAll('tag').join(','));
params.set('tag', 'api');
params.set('q', 'hello world');
console.log(url.href);Risultato
js,web https://example.com/?tag=api&q=hello+world
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.