CKTIS / JavaScript
URLSearchParams — parametry dotazu
URLSearchParams čte a upravuje parametry dotazu, zachovává opakované názvy a pracuje s kódováním ve stylu formulářů.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
new URLSearchParams()
new URLSearchParams(init)
params.get(name)
params.getAll(name)
params.append(name, value)
params.set(name, value)
params.toString()URLSearchParams je API standardu WHATWG URL, nikoli ECMAScriptu. Konstruktor přijímá dotaz (volitelně začínající znakem ?), záznam nebo dvojice název–hodnota; celou URL neparsuje.
get() vrací první hodnotu nebo null; getAll() vrací všechny hodnoty. append() přidá dvojici. Pokud zadaný název už existuje, set() změní hodnotu první dvojice s tímto názvem a odstraní ostatní dvojice se stejným názvem. Jinak set() přidá na konec novou dvojici.
toString() vynechá ? a používá application/x-www-form-urlencoded: mezery se změní na + a doslovná znaménka plus na %2B. Metodám předávejte nekódované hodnoty.
Změny url.searchParams aktualizují související URL a mohou změnit její kódování. Standard není tabulkou kompatibility prohlížečů; Node 24 nedokazuje podporu v prohlížečích.
Příklady
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());Výsledek
js,web tag=api&q=a%2Bb+c
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.