CKTIS / JavaScript
URL.searchParams — parametry zapytania
URL.searchParams udostępnia parametry zapytania jako obiekt URLSearchParams powiązany z adresem URL.
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
url.searchParamsURL.searchParams to właściwość instancji URL, nie metoda statyczna. Jest tylko do odczytu, ale zwracany obiekt URLSearchParams jest modyfikowalny. Zmiany aktualizują URL; kolejne odczyty zwracają ten sam obiekt.
get() zwraca pierwszą wartość lub null; getAll() obsługuje powtórzone nazwy. set() zastępuje wartości danej nazwy jedną wartością.
Serializacja używa application/x-www-form-urlencoded: spacja staje się +. To Web API określone przez WHATWG, nie przez wydanie ECMAScript; zgodność przeglądarki wymaga osobnego sprawdzenia.
Przykłady
const url = new URL('https://example.com/?tag=js&tag=web');
const params = url.searchParams;
console.log(params.getAll('tag').join(','));
params.set('tag', 'api');
params.set('q', 'hello world');
console.log(url.href);Wynik
js,web https://example.com/?tag=api&q=hello+world
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.