База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

URLSearchParams — параметри на заявката

URLSearchParams чете и променя параметри на заявката, запазва повтарящите се имена и обработва форматирането за кодиране на формуляри.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

new URLSearchParams()
new URLSearchParams(init)
params.get(name)
params.getAll(name)
params.append(name, value)
params.set(name, value)
params.toString()

URLSearchParams е API от стандарта WHATWG URL, а не от ECMAScript. Конструкторът приема заявка (по желание с начален ?), запис или двойки име–стойност; не анализира пълен URL.

get() връща първата стойност или null; getAll() връща всички стойности. append() добавя двойка. Ако вече има двойка с посоченото име, set() променя стойността на първата такава двойка и премахва останалите двойки със същото име. Ако няма такава двойка, set() добавя нова двойка в края.

toString() пропуска ? и използва application/x-www-form-urlencoded: интервалите стават +, а буквалните знаци плюс — %2B. Подавате на методите некодирани стойности.

Промените в url.searchParams актуализират свързания URL и могат да променят кодирането му. Стандартът не е таблица за съвместимост на браузърите; Node 24 не доказва поддръжка в браузърите.

Примери

const params = new URLSearchParams("tag=js&tag=web");
console.log(params.getAll("tag").join(","));
params.set("tag", "api");
params.append("q", "a+b c");
console.log(params.toString());

Резултат

js,web
tag=api&q=a%2Bb+c

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници