CKTIS / JavaScript
URLSearchParams — parámetros de consulta
URLSearchParams lee y modifica parámetros de consulta, conserva los nombres repetidos y gestiona la codificación de tipo formulario.
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
new URLSearchParams()
new URLSearchParams(init)
params.get(name)
params.getAll(name)
params.append(name, value)
params.set(name, value)
params.toString()URLSearchParams es una API del estándar WHATWG URL, no de ECMAScript. Su constructor acepta una consulta (opcionalmente precedida por ?), un registro o pares nombre-valor; no analiza una URL completa.
get() devuelve el primer valor o null; getAll() devuelve todos los valores. append() añade un par. Si el nombre indicado ya existe, set() cambia el valor del primer par con ese nombre y elimina los demás pares que lo tengan. Si no existe, set() añade un nuevo par al final.
toString() omite ? y usa application/x-www-form-urlencoded: los espacios se convierten en + y los signos más literales, en %2B. Pasa valores sin codificar a los métodos.
Modificar url.searchParams actualiza la URL asociada y puede cambiar su codificación. El estándar no es una tabla de compatibilidad de navegadores; Node 24 no demuestra que haya compatibilidad en los navegadores.
Ejemplos
const params = new URLSearchParams("tag=js&tag=web");
console.log(params.getAll("tag").join(","));
params.set("tag", "api");
params.append("q", "a+b c");
console.log(params.toString());Resultado
js,web tag=api&q=a%2Bb+c
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.