CKTIS / JavaScript
URLSearchParams.prototype.toString — serijalizacija parametara upita
Poziv `params.toString()` vraća parametre upita kao tekst bez početnog znaka `?`. Koristi kodiranje obrazaca i pritom čuva redoslijed i ponovljene nazive.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
params.toString()URLSearchParams.prototype.toString metoda je instance koja serijalizira parametre upita. Pozovite je bez argumenata kao params.toString(). Svojstvo konstruktora URLSearchParams.toString pak upućuje na naslijeđenu metodu Function.prototype.toString, koja ne serijalizira parametre.
Metoda instance vraća tekst parametara bez početnog znaka ?, a ne cijeli URL. Prazan popis daje "".
Serijalizacija koristi application/x-www-form-urlencoded i UTF-8: razmak postaje +, a doslovni + postaje %2B. Proslijedite nekodirane vrijednosti kako biste izbjegli ponovno kodiranje znaka %.
Parovi se spajaju znakom &, a naziv i vrijednost znakom =. Redoslijed i ponovljeni nazivi ostaju sačuvani; prazna vrijednost daje name=. Metoda ne sortira niti mijenja parametre. Riječ je o web API-ju iz standarda URL Standard, a ne o značajci definiranoj standardom ECMAScript.
Primjeri
const params = new URLSearchParams([
["q", "a b+c"],
["tag", "js"],
["tag", "web"],
["empty", ""]
]);
console.log(params.toString());
console.log(JSON.stringify(new URLSearchParams().toString()));Rezultat
q=a+b%2Bc&tag=js&tag=web&empty= ""
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere upravo te verzije.