Esta página ha sido traducida del inglés por la comunidad. Aprende más y únete a la comunidad de MDN Web Docs.

View in English Always switch to English

URLSearchParams()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨abril de 2018⁩.

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
# dom-urlsearchparams-urlsearchparams

Compatibilidad con navegadores