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

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.

Fuentes