CKTIS / JavaScript
URLSearchParams.get — odczyt parametru zapytania
URLSearchParams.get(name) zwraca pierwszą wartość parametru jako tekst albo null, gdy parametr nie istnieje.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
params.get(name)params.get(name) odczytuje pierwszą wartość o podanej nazwie, rozróżniając wielkość liter. Nie zmienia parametrów. Przy powtórzeniach użyj getAll(name), aby otrzymać wszystkie wartości.
Wynikiem jest tekst albo null. Pusta wartość, np. empty=, daje "", a nie null.
Podczas parsowania tekstu zapytania URLSearchParams dekoduje kodowanie procentowe i zamienia + na spację; %2B oznacza dosłowny plus. get() odczytuje już zdekodowaną wartość.
To API definiuje WHATWG URL Standard, nie wydanie ECMAScript. Obecność w Node 24 nie potwierdza obsługi w przeglądarce.
Przykłady
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')
}));Wynik
{"tag":"web","q":"hello world","empty":"","missing":null}Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.