Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

URLSearchParams.delete(): eliminar parámetros de consulta

URLSearchParams.delete() elimina todos los pares con un nombre determinado o solo los que coinciden tanto con el nombre como con el valor indicados.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

params.delete(name)
params.delete(name, value)

params.delete(name) elimina todos los pares cuyo nombre sea name, incluidos los duplicados. params.delete(name, value) elimina todos los pares que coincidan tanto con el nombre como con el valor, no solo el primero.

El método modifica el objeto y devuelve undefined, no el número de pares eliminados. Si no hay coincidencias, no se produce ningún error. Si el objeto se obtuvo mediante url.searchParams, también actualiza la consulta de esa URL.

Esta API forma parte del estándar WHATWG URL, no de una edición concreta de ECMAScript. Comprueba si la forma con value es compatible con el entorno de destino; que Node 24 esté disponible en un repositorio no demuestra por sí solo la compatibilidad de los navegadores.

Ejemplos

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());

Resultado

tag=web&page=2
page=2

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes