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.