URLSearchParams: delete() method

name

The name of the parameters to be deleted.

value Optional

The value that parameters must match, along with the given name, to be deleted.

None (undefined).

This example shows how to delete all query parameters (and values) that have a particular name.

<pre id="log"></pre>

const logElement = document.getElementById("log");
function log(text) {
  logElement.innerText += `${text}\n`;
}

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

The log below shows that all parameters that have the name of foo are deleted.

This example shows how to delete query parameters that match a particular name and value.

<pre id="log"></pre>

const logElement = document.getElementById("log");
function log(text) {
  logElement.innerText += `${text}\n`;
}

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

All parameters that match both the parameter name and value should be deleted (there is no reason to specify two parameters with the same name and value as shown above).

If your browser supports the value option, the "after" string should be bar=2&foo=3. Otherwise the result will be the same as in the previous example (bar=2).

• Polyfill of URLSearchParams in core-js