Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori