Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje