CKTIS / JavaScript
URL.searchParams — parámetros de consulta
URL.searchParams expone los parámetros de consulta como un objeto URLSearchParams vinculado a la URL.
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
url.searchParamsURL.searchParams es una propiedad de una instancia de URL, no un método estático. La propiedad es de solo lectura, pero el objeto URLSearchParams que devuelve se puede modificar. Los cambios actualizan la URL; las lecturas repetidas devuelven el mismo objeto.
get() devuelve el primer valor o null; getAll() permite gestionar nombres repetidos. set() reemplaza los valores de un nombre por un único valor.
La serialización usa application/x-www-form-urlencoded: un espacio se convierte en +. Esta es una API web de WHATWG, no una característica de una edición de ECMAScript; la compatibilidad con los navegadores debe comprobarse por separado.
Ejemplos
const url = new URL('https://example.com/?tag=js&tag=web');
const params = url.searchParams;
console.log(params.getAll('tag').join(','));
params.set('tag', 'api');
params.set('q', 'hello world');
console.log(url.href);Resultado
js,web https://example.com/?tag=api&q=hello+world
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.