Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.searchParams

URL.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.

Zdroje