CKTIS / JavaScript
URLSearchParams.prototype.toString — сериализиране на параметри на заявка
Извикването на `params.toString()` връща параметрите на заявката като текст без начален знак `?`. Методът използва формулярно кодиране и запазва реда и повтарящите се имена.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
params.toString()URLSearchParams.prototype.toString е методът на екземпляра, който сериализира параметрите на заявката. Извикайте го без аргументи като params.toString(). За разлика от него свойството URLSearchParams.toString на конструктора сочи към наследения метод Function.prototype.toString, който не сериализира параметрите.
Методът на екземпляра връща текста на параметрите без начален знак ?, а не пълен URL. Празен списък дава "".
Сериализацията използва application/x-www-form-urlencoded и UTF-8: интервалът става +, а буквалният + става %2B. Подават се некодирани стойности, за да не се кодира % повторно.
Двойките се свързват с &, а имената и стойностите — с =. Редът и повтарящите се имена се запазват; празна стойност дава name=. Методът нито сортира, нито променя параметрите. Това е уеб API от стандарта URL Standard, а не функционалност, дефинирана от ECMAScript.
Примери
const params = new URLSearchParams([
["q", "a b+c"],
["tag", "js"],
["tag", "web"],
["empty", ""]
]);
console.log(params.toString());
console.log(JSON.stringify(new URLSearchParams().toString()));Резултат
q=a+b%2Bc&tag=js&tag=web&empty= ""
Показаният код и посоченият резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на същата версия.