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.