Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

URLSearchParams — parametry zapytania

URLSearchParams odczytuje i zmienia parametry zapytania, zachowując powtarzające się nazwy oraz obsługując kodowanie formularzowe.

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

new URLSearchParams()
new URLSearchParams(init)
params.get(name)
params.getAll(name)
params.append(name, value)
params.set(name, value)
params.toString()

URLSearchParams to API standardu WHATWG URL, nie ECMAScript. Konstruktor przyjmuje zapytanie (opcjonalnie z początkowym ?), rekord lub pary nazwa–wartość; nie parsuje pełnego URL.

get() zwraca pierwszą wartość albo null; getAll() — wszystkie. append() dodaje parę. Jeśli istnieje para o podanej nazwie, set() zmienia wartość pierwszej takiej pary i usuwa pozostałe pary o tej nazwie. Jeśli nie ma takiej pary, set() dodaje nową parę na końcu.

toString() pomija ? i stosuje application/x-www-form-urlencoded: spacja staje się +, a dosłowny plus — %2B. Przekazuj niezakodowane wartości metodom.

Zmiany url.searchParams aktualizują powiązany URL i mogą zmienić jego kodowanie. Standard nie stanowi tabeli zgodności przeglądarek; Node 24 nie dowodzi ich wsparcia.

Przykłady

const params = new URLSearchParams("tag=js&tag=web");
console.log(params.getAll("tag").join(","));
params.set("tag", "api");
params.append("q", "a+b c");
console.log(params.toString());

Wynik

js,web
tag=api&q=a%2Bb+c

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła