CKTIS / JavaScript
URLSearchParams — parametri upita
URLSearchParams čita i mijenja parametre upita, čuva ponovljene nazive i podržava kodiranje u stilu obrazaca.
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
new URLSearchParams()
new URLSearchParams(init)
params.get(name)
params.getAll(name)
params.append(name, value)
params.set(name, value)
params.toString()URLSearchParams API je standarda WHATWG URL, a ne ECMAScripta. Konstruktor prihvaća upit (po želji s početnim znakom ?), zapis ili parove naziv-vrijednost; ne parsira cijeli URL.
get() vraća prvu vrijednost ili null; getAll() vraća sve vrijednosti. append() dodaje par. Ako zadani naziv već postoji, set() mijenja vrijednost prvog para s tim nazivom i uklanja ostale parove s istim nazivom. U suprotnom set() dodaje novi par na kraj.
toString() izostavlja ? i koristi application/x-www-form-urlencoded: razmaci postaju +, a doslovni znakovi plus postaju %2B. Metodama proslijedite nekodirane vrijednosti.
Promjene na url.searchParams ažuriraju povezani URL i mogu promijeniti njegovo kodiranje. Standard nije tablica kompatibilnosti preglednika; Node 24 ne dokazuje podršku u preglednicima.
Primjeri
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());Rezultat
js,web tag=api&q=a%2Bb+c
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.