CKTIS / JavaScript
URLSearchParams.prototype.toString — serializácia parametrov dopytu
Volanie `params.toString()` vracia parametre dopytu ako text bez úvodného `?`. Používa formulárové kódovanie a zachováva poradie aj opakované názvy.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
params.toString()URLSearchParams.prototype.toString je metóda inštancie, ktorá serializuje parametre dopytu. Zavolajte ju bez argumentov ako params.toString(). Vlastnosť konštruktora URLSearchParams.toString naopak odkazuje na zdedenú metódu Function.prototype.toString, ktorá parametre neserializuje.
Metóda inštancie vracia text parametrov bez úvodného ?, nie celú URL. Prázdny zoznam dáva "".
Serializácia používa application/x-www-form-urlencoded a UTF-8: medzera sa zmení na + a doslovné + na %2B. Odovzdávajte nekódované hodnoty, aby sa znak % nezakódoval znova.
Dvojice sa spájajú pomocou &, názov a hodnota pomocou =. Poradie aj opakované názvy zostávajú zachované; prázdna hodnota vytvorí name=. Metóda parametre netriedi ani nemení. Ide o webové API zo štandardu URL Standard, nie o funkciu definovanú štandardom ECMAScript.
Príklady
const params = new URLSearchParams([
["q", "a b+c"],
["tag", "js"],
["tag", "web"],
["empty", ""]
]);
console.log(params.toString());
console.log(JSON.stringify(new URLSearchParams().toString()));Výsledok
q=a+b%2Bc&tag=js&tag=web&empty= ""
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.