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.