Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

URLSearchParams.prototype.toString — serializacja parametrów zapytania

Wywołanie `params.toString()` zwraca parametry zapytania jako tekst bez początkowego `?`. Metoda stosuje kodowanie formularzowe, zachowując kolejność i powtórzone nazwy.

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

Składnia

params.toString()

URLSearchParams.prototype.toString to metoda instancji, która serializuje parametry zapytania. Wywołaj ją bez argumentów jako params.toString(). Właściwość URLSearchParams.toString na konstruktorze wskazuje natomiast na odziedziczoną metodę Function.prototype.toString, która nie serializuje parametrów.

Metoda instancji zwraca tekst parametrów bez początkowego ?, a nie pełny URL. Pusta lista daje "".

Serializacja używa application/x-www-form-urlencoded i UTF-8: spacja staje się +, a dosłowny + — %2B. Przekazuj niezakodowane wartości, aby uniknąć ponownego kodowania %.

Pary łączy &, nazwę i wartość — =. Kolejność i powtórzone nazwy pozostają zachowane; pusta wartość daje name=. Metoda nie sortuje ani nie zmienia parametrów. To Web API z URL Standard, nie funkcja zdefiniowana przez ECMAScript.

Przykłady

const params = new URLSearchParams([
  ["q", "a b+c"],
  ["tag", "js"],
  ["tag", "web"],
  ["empty", ""]
]);
console.log(params.toString());
console.log(JSON.stringify(new URLSearchParams().toString()));

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła