URLSearchParams: метод delete()

Метод delete() интерфейса URLSearchParams удаляет указанные параметры и их соответствующие значения из списка всех параметров поиска.

Для сопоставления параметров используется имя параметра и необязательное значение. Если указано только имя параметра, то удаляются все параметры поиска, соответствующие этому имени, вместе с их соответствующими значениями. Если указаны имя параметра и значение, то удаляются все параметры поиска, соответствующие как имени параметра, так и значению.

name

Имя параметров, которые нужно удалить.

value Необязательно

Значение, которому должны соответствовать параметры, вместе с заданным именем, чтобы быть удалёнными.

Ничего (undefined).

Этот пример показывает, как удалить все параметры запроса (и значения), имеющие определённое имя.

const url = new URL("https://example.com?foo=1&bar=2&foo=3");
const params = new URLSearchParams(url.search);
console.log(`Query string (before):\t ${params}`);
params.delete("foo");
console.log(`Query string (after):\t ${params}`);

В логе ниже показано, что все параметры с именем foo удалены.

Query string (before):  foo=1&bar=2&foo=3
Query string (after):   bar=2

Этот пример показывает, как удалить параметры запроса, которые соответствуют определённому имени и значению.

const url = new URL("https://example.com?foo=1&bar=2&foo=3&foo=1");
const params = new URLSearchParams(url.search);
console.log(`Query string (before):\t ${params}`);
params.delete("foo", "1");
console.log(`Query string (after):\t ${params}`);

Все параметры, которые соответствуют как параметру name, так и значению value, должны быть удалены (нет смысла указывать два параметра с одинаковым именем и значением, как показано выше).

Query string (before):  foo=1&bar=2&foo=3&foo=1
Query string (after):   bar=2&foo=3

Если ваш браузер поддерживает опцию value, строка "after" должна быть bar=2&foo=3. В противном случае результат будет таким же, как в предыдущем примере (bar=2).

• Полифил URLSearchParams в core-js