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.