CKTIS / JavaScript
URLSearchParams — parametre dotazu
URLSearchParams číta a upravuje parametre dotazu, zachováva opakované názvy a pracuje s kódovaním v štýle formulárov.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
new URLSearchParams()
new URLSearchParams(init)
params.get(name)
params.getAll(name)
params.append(name, value)
params.set(name, value)
params.toString()URLSearchParams je API štandardu WHATWG URL, nie ECMAScriptu. Konštruktor prijíma dotaz (voliteľne začínajúci znakom ?), záznam alebo dvojice názov–hodnota; celú URL neparsuje.
get() vracia prvú hodnotu alebo null; getAll() vracia všetky hodnoty. append() pridá dvojicu. Ak zadaný názov už existuje, set() zmení hodnotu prvej dvojice s týmto názvom a odstráni ostatné dvojice s rovnakým názvom. Inak set() pridá na koniec novú dvojicu.
toString() vynechá ? a používa application/x-www-form-urlencoded: medzery sa zmenia na + a doslovné znamienka plus na %2B. Metódam odovzdávajte nekódované hodnoty.
Zmeny url.searchParams aktualizujú súvisiacu URL a môžu zmeniť jej kódovanie. Štandard nie je tabuľkou kompatibility prehliadačov; Node 24 nedokazuje podporu v prehliadačoch.
Prí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ýsledok
js,web tag=api&q=a%2Bb+c
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.