Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

URLSearchParams.prototype.toString — serializzare i parametri di ricerca

La chiamata `params.toString()` restituisce i parametri di ricerca come testo, senza un `?` iniziale. Usa la codifica dei moduli e mantiene l’ordine e i nomi ripetuti.

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

params.toString()

URLSearchParams.prototype.toString è il metodo di istanza che serializza i parametri di ricerca. Chiamalo senza argomenti con params.toString(). La proprietà URLSearchParams.toString del costruttore rimanda invece al metodo ereditato Function.prototype.toString, che non serializza i parametri.

Il metodo di istanza restituisce il testo dei parametri senza un ? iniziale, non un URL completo. Un elenco vuoto produce "".

La serializzazione usa application/x-www-form-urlencoded e UTF-8: uno spazio diventa + e un + letterale diventa %2B. Fornisci valori non codificati per evitare che % venga codificato di nuovo.

Le coppie sono unite con &, mentre nomi e valori sono separati da =. L’ordine e i nomi ripetuti vengono mantenuti; un valore vuoto produce name=. Il metodo non ordina né modifica i parametri. È un’API Web dello URL Standard, non una funzionalità definita da ECMAScript.

Esempi

const params = new URLSearchParams([
  ["q", "a b+c"],
  ["tag", "js"],
  ["tag", "web"],
  ["empty", ""]
]);
console.log(params.toString());
console.log(JSON.stringify(new URLSearchParams().toString()));

Risultato

q=a+b%2Bc&tag=js&tag=web&empty=
""

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