CKTIS / JavaScript
URLSearchParams.set(): establecer un parámetro de consulta
URLSearchParams.set() asigna un valor a un parámetro y elimina sus duplicados o añade el nombre si aún no existe.
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.set(name, value)params.set(name, value) modifica el objeto y devuelve undefined, por lo que no se pueden encadenar llamadas. Ambos argumentos son obligatorios y se convierten en cadenas de texto.
El método sustituye el valor de la primera entrada coincidente, conservando su posición, y elimina las demás entradas con ese nombre. Si el nombre no existe, lo añade al final. En cambio, append() conserva los duplicados.
Pasa texto sin codificar. Al serializar, los espacios se convierten en + y los signos + literales en %2B. Una llamada a url.searchParams.set() actualiza el objeto URL asociado.
Esta API web forma parte del WHATWG URL Standard, no de una edición concreta de ECMAScript. Comprueba su disponibilidad en el entorno de destino; Node 24 no demuestra que los navegadores la admitan.
Ejemplos
const params = new URLSearchParams('q=old&page=1&q=extra');
const result = params.set('q', 'a+b c');
params.set('lang', 'pl');
console.log(params.toString());
console.log(result === undefined);Resultado
q=a%2Bb+c&page=1&lang=pl true
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.