Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

URLSearchParams.prototype.toString — serializace parametrů dotazu

Volání `params.toString()` vrací parametry dotazu jako text bez úvodního `?`. Používá formulářové kódování a zachovává pořadí i opakované názvy.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

params.toString()

URLSearchParams.prototype.toString je metoda instance, která serializuje parametry dotazu. Zavolejte ji bez argumentů jako params.toString(). Vlastnost konstruktoru URLSearchParams.toString naproti tomu odkazuje na zděděnou metodu Function.prototype.toString, která parametry neserializuje.

Metoda instance vrací text parametrů bez úvodního ?, nikoli celou URL. Prázdný seznam dává "".

Serializace používá application/x-www-form-urlencoded a UTF-8: mezera se změní na + a doslovné + na %2B. Předávejte nekódované hodnoty, aby se znak % znovu nekódoval.

Dvojice se spojují pomocí &, název a hodnota pomocí =. Pořadí i opakované názvy zůstávají zachovány; prázdná hodnota vytvoří name=. Metoda parametry netřídí ani nemění. Jde o webové API ze standardu URL Standard, nikoli o funkci definovanou standardem ECMAScript.

Pří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ýsledek

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

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje