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

// 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

Especificación Estado Comentario
URL
La definición de 'URLSearchParams()' en esta especificación.
Living Standard Definición inicial.

Compatibilidad de browsers

BCD tables only load in the browser