URLSearchParams

`URLSearchParams.prototype.delete`

Removes the given search parameter and all its associated values

Syntax

JavaScript

params.delete(name, value?)

Parameters

Parameter	Type	Description
name	string	The name of the parameter to remove
value	string	Optional specific value to delete

Return Value

undefined

Examples

Basic Usage

const params = new URLSearchParams('q=hello&page=1')
params.delete('page')
console.log(params.toString()) // 'q=hello'

Practical Example

function removeQueryParam(name: string) {
  const url = new URL(window.location.href)
  url.searchParams.delete(name)
  history.replaceState({}, '', url)
}

Advanced Usage

const params = new URLSearchParams('a=1&b=2&c=3')
;['a', 'c'].forEach(k => params.delete(k))
console.log(params.toString()) // 'b=2'

Understanding URLSearchParams.prototype.delete

The URLSearchParams.prototype.delete method in JavaScript removes the given search parameter and all its associated values. It belongs to the URLSearchParams object and is one of the most widely used methods for working with urlsearchparams values in modern JavaScript and TypeScript applications.

The method signature is params.delete(name, value?). It accepts 2 parameters: name, value. When called, it returns undefined. Understanding when and how to use delete() helps you write more expressive, readable code.

Common use cases for URLSearchParams.prototype.delete include data transformation, input validation, API response processing, and building reusable utility functions. It works well alongside related methods like urlsearchparams-set, urlsearchparams-get, urlsearchparams-has, enabling you to chain operations together for complex data manipulation pipelines.

Browser support for URLSearchParams.prototype.delete is excellent across all modern browsers including Chrome, Firefox, Safari, and Edge. It is also fully supported in Node.js and Deno. For older environments, transpilation with Babel or a polyfill may be needed.