Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

URLSearchParams.prototype.toString — serializacija poizvedbenih parametrov

Klic `params.toString()` vrne poizvedbene parametre kot besedilo brez začetnega `?`. Uporablja kodiranje obrazcev ter ohrani vrstni red in ponovljena imena.

Različica: 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 je metoda primerka, ki serializira poizvedbene parametre. Pokličite jo brez argumentov kot params.toString(). Lastnost konstruktorja URLSearchParams.toString pa se sklicuje na podedovano metodo Function.prototype.toString, ki parametrov ne serializira.

Metoda primerka vrne besedilo parametrov brez začetnega ?, ne celotnega URL-ja. Prazen seznam da "".

Serializacija uporablja application/x-www-form-urlencoded in UTF-8: presledek postane +, dobesedni + pa %2B. Podajte nekodirane vrednosti, da se % ne kodira znova.

Pare povezuje znak &, imena in vrednosti pa znak =. Vrstni red in ponovljena imena se ohranijo; prazna vrednost da name=. Metoda parametrov ne razvršča in jih ne spreminja. To je spletni API iz standarda URL Standard, ne funkcija, določena v ECMAScriptu.

Primeri

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=
""

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju prav te različice.

Viri