URLSearchParams()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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, una secuencia de USVStrings, o un registro conteniendo dos USVStrings.

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