CKTIS / JavaScript
URL.searchParams — parametre dotazu
URL.searchParams sprístupňuje parametre dotazu ako objekt URLSearchParams prepojený s adresou URL.
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
url.searchParamsURL.searchParams je vlastnosť inštancie URL, nie statická metóda. Vlastnosť je iba na čítanie, ale vrátený objekt URLSearchParams možno meniť. Zmeny aktualizujú URL; opakované čítanie vracia ten istý objekt.
get() vracia prvú hodnotu alebo null; getAll() pracuje s opakovanými názvami. set() nahradí hodnoty daného názvu jedinou hodnotou.
Serializácia používa application/x-www-form-urlencoded: medzera sa zmení na +. Ide o webové API WHATWG, nie o funkciu niektorej edície ECMAScript; kompatibilitu prehliadačov treba overiť samostatne.
Príklady
const url = new URL('https://example.com/?tag=js&tag=web');
const params = url.searchParams;
console.log(params.getAll('tag').join(','));
params.set('tag', 'api');
params.set('q', 'hello world');
console.log(url.href);Výsledok
js,web https://example.com/?tag=api&q=hello+world
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.