Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.searchParams

URL.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.

Źródła