Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.searchParams

URL.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.

Fonti