CKTIS / JavaScript
URLSearchParams — parametri poizvedbe
URLSearchParams bere in spreminja parametre poizvedbe, ohranja ponovljena imena in podpira kodiranje v slogu obrazcev.
Različica: 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 je API standarda WHATWG URL, ne ECMAScript. Konstruktor sprejme poizvedbo (po želji z začetnim ?), zapis ali pare ime–vrednost; celotnega URL-ja ne razčleni.
get() vrne prvo vrednost ali null; getAll() vrne vse vrednosti. append() doda par. Če navedeno ime že obstaja, set() spremeni vrednost prvega para s tem imenom in odstrani vse preostale pare z istim imenom. Sicer set() na konec doda nov par.
toString() izpusti ? in uporablja application/x-www-form-urlencoded: presledki postanejo +, dobesedni znaki plus pa %2B. Metodam podajte nekodirane vrednosti.
Spreminjanje url.searchParams posodobi povezani URL in lahko spremeni njegovo kodiranje. Standard ni tabela združljivosti brskalnikov; Node 24 ne dokazuje podpore v brskalnikih.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.