Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

URLSearchParams.delete(): usuwanie parametrów zapytania

URLSearchParams.delete() usuwa wszystkie pary o podanej nazwie albo tylko pary pasujące jednocześnie do nazwy i wartości.

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

params.delete(name) usuwa wszystkie pary o nazwie name, także powtórzenia. params.delete(name, value) usuwa wszystkie pary pasujące jednocześnie do nazwy i wartości, nie tylko pierwszą.

Metoda zmienia obiekt i zwraca undefined, nie liczbę usuniętych par. Brak dopasowania nie powoduje błędu. Dla obiektu uzyskanego przez url.searchParams aktualizuje też zapytanie tego URL.

To API standardu WHATWG URL, nie funkcja konkretnej edycji ECMAScript. Wsparcie wariantu z value sprawdź w docelowym środowisku; sam Node 24 w repozytorium nie potwierdza wsparcia przeglądarek.

Przykłady

const params = new URLSearchParams('tag=js&tag=web&tag=js&page=2');
params.delete('tag', 'js');
console.log(params.toString());
params.delete('tag');
console.log(params.toString());

Wynik

tag=web&page=2
page=2

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

Źródła