Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

URLSearchParams — parametri di query

URLSearchParams legge e modifica i parametri di query, conserva i nomi ripetuti e gestisce la codifica in stile modulo.

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 URLSearchParams()
new URLSearchParams(init)
params.get(name)
params.getAll(name)
params.append(name, value)
params.set(name, value)
params.toString()

URLSearchParams è un’API dello standard WHATWG URL, non di ECMAScript. Il costruttore accetta una query (eventualmente preceduta da ?), un record o coppie nome-valore; non analizza un URL completo.

get() restituisce il primo valore o null; getAll() restituisce tutti i valori. append() aggiunge una coppia. Se il nome indicato è già presente, set() modifica il valore della prima coppia con quel nome e rimuove le altre coppie con lo stesso nome. Altrimenti, set() aggiunge una nuova coppia in coda.

toString() omette ? e usa application/x-www-form-urlencoded: gli spazi diventano + e i segni più letterali diventano %2B. Passa valori non codificati ai metodi.

Le modifiche a url.searchParams aggiornano l’URL associato e possono cambiarne la codifica. Lo standard non è una tabella di compatibilità dei browser; Node 24 non dimostra il supporto nei browser.

Esempi

const params = new URLSearchParams("tag=js&tag=web");
console.log(params.getAll("tag").join(","));
params.set("tag", "api");
params.append("q", "a+b c");
console.log(params.toString());

Risultato

js,web
tag=api&q=a%2Bb+c

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