Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

URLSearchParams.set(): ustawianie parametru zapytania

URLSearchParams.set() ustawia jedną wartość parametru, usuwając jego duplikaty albo dodając brakującą nazwę.

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.set(name, value)

params.set(name, value) zmienia obiekt i zwraca undefined, więc nie umożliwia łączenia wywołań w łańcuch. Oba argumenty są wymagane i konwertowane na tekst.

Metoda zastępuje wartość pierwszego pasującego wpisu, zachowując jego pozycję, i usuwa pozostałe wpisy tej nazwy. Brakującą nazwę dodaje na końcu. Natomiast append() zachowuje duplikaty.

Przekazuj niezakodowany tekst. Przy serializacji spacja staje się +, a dosłowny + — %2B. Zmiana przez url.searchParams.set() aktualizuje powiązany obiekt URL.

To Web API z WHATWG URL Standard, nie funkcja określonej edycji ECMAScript. Dostępność sprawdzaj w docelowym środowisku; Node 24 nie dowodzi obsługi w przeglądarkach.

Przykłady

const params = new URLSearchParams('q=old&page=1&q=extra');
const result = params.set('q', 'a+b c');
params.set('lang', 'pl');
console.log(params.toString());
console.log(result === undefined);

Wynik

q=a%2Bb+c&page=1&lang=pl
true

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

Źródła