Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła