URLSearchParams()

El constructor URLSearchParams() crea y retorna un nuevo objeto URLSearchParams. Si se incluye el caracter '?' al comienzo, éste es ignorado.

Nota: Esta característica está disponible en Web Workers.

Sintaxis

var URLSearchParams = new URLSearchParams(init);

Parámetros

init Opcional

Una instancia de USVString (en-US), una secuencia de USVString (en-US)s, o un registro conteniendo dos USVString (en-US)s.

Valor retornado

Un objeto instancia de URLSearchParams.

Ejemplos

El siguiente ejemplo muestra cómo crear un objeto URLSearchParams desde un string que representa una URL.

js
// Pasar un literal string
var url = new URL("https://example.com?foo=1&bar=2");
// Obtener la URL actual desde window.location
var url2 = new URL(window.location);

// Obtener parámetros de url.search y pasarlos al constructor
var params = new URLSearchParams(url.search);
var params2 = new URLSearchParams(url2.search);

// Pasar una secuencia
var params3 = new URLSearchParams([
  ["foo", 1],
  ["bar", 2],
]);

// Pasar un registro
var params4 = new URLSearchParams({ foo: 1, bar: 2 });

Especificaciones

Specification
URL Standard
# dom-urlsearchparams-urlsearchparams

Compatibilidad con navegadores

BCD tables only load in the browser