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

CKTIS / JavaScript

URLSearchParams.get — čtení parametru dotazu

URLSearchParams.get(name) vrátí první hodnotu parametru jako řetězec, nebo null, pokud parametr chybí.

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

params.get(name)

params.get(name) přečte první hodnotu s uvedeným názvem; při porovnání rozlišuje velká a malá písmena. Parametry nemění. Pokud se název opakuje, použijte getAll(name), abyste získali všechny hodnoty.

Výsledkem je řetězec nebo null. Prázdná hodnota, například empty=, vrátí "", nikoli null.

Při parsování řetězce dotazu URLSearchParams dekóduje procentové kódování a převádí + na mezeru; %2B představuje doslovné znaménko plus. get() čte již dekódovanou hodnotu.

Toto API definuje WHATWG URL Standard, nikoli některé vydání ECMAScriptu. Dostupnost v Node 24 nepotvrzuje podporu v prohlížečích.

Příklady

const params = new URLSearchParams('tag=web&tag=api&q=hello+world&empty=');
console.log(JSON.stringify({
  tag: params.get('tag'),
  q: params.get('q'),
  empty: params.get('empty'),
  missing: params.get('missing')
}));

Výsledek

{"tag":"web","q":"hello world","empty":"","missing":null}

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