CKTIS / JavaScript
URL.searchParams — parametry dotazu
URL.searchParams zpřístupňuje parametry dotazu jako objekt URLSearchParams propojený s adresou URL.
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
url.searchParamsURL.searchParams je vlastnost instance URL, nikoli statická metoda. Vlastnost je jen pro čtení, ale vrácený objekt URLSearchParams lze měnit. Změny aktualizují URL; opakované čtení vrací tentýž objekt.
get() vrací první hodnotu nebo null; getAll() pracuje s opakovanými názvy. set() nahradí hodnoty daného názvu jedinou hodnotou.
Serializace používá application/x-www-form-urlencoded: mezera se změní na +. Jde o webové API WHATWG, nikoli o funkci některé edice ECMAScript; kompatibilitu prohlížečů je třeba ověřit samostatně.
Pří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ýsledek
js,web https://example.com/?tag=api&q=hello+world
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.