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

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.searchParams

URL.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.

Fuentes