Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

URLSearchParams.prototype.toString — serijalizacija parametara upita

Poziv `params.toString()` vraća parametre upita kao tekst bez početnog znaka `?`. Koristi kodiranje obrazaca i pritom čuva redoslijed i ponovljene nazive.

Verzija: 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 metoda je instance koja serijalizira parametre upita. Pozovite je bez argumenata kao params.toString(). Svojstvo konstruktora URLSearchParams.toString pak upućuje na naslijeđenu metodu Function.prototype.toString, koja ne serijalizira parametre.

Metoda instance vraća tekst parametara bez početnog znaka ?, a ne cijeli URL. Prazan popis daje "".

Serijalizacija koristi application/x-www-form-urlencoded i UTF-8: razmak postaje +, a doslovni + postaje %2B. Proslijedite nekodirane vrijednosti kako biste izbjegli ponovno kodiranje znaka %.

Parovi se spajaju znakom &, a naziv i vrijednost znakom =. Redoslijed i ponovljeni nazivi ostaju sačuvani; prazna vrijednost daje name=. Metoda ne sortira niti mijenja parametre. Riječ je o web API-ju iz standarda URL Standard, a ne o značajci definiranoj standardom ECMAScript.

Primjeri

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere upravo te verzije.

Izvori