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.

La interfaz URLSearchParams define métodos útiles para trabajar con los parámetros de búsqueda de una URL.

Un objeto implementando URLSearchParams puede directamente ser usado en una for...of estructura, en lugar de entries(): for (var p of mySearchParams) la cual es equivalente a for (var p of mySearchParams.entries()).

Constructor

URLSearchParams()

El Constructor returna un objeto de tipo URLSearchParams.

Propiedades

Esta interfaz no hereda ninguna propiedad.

Métodos

Esta interfaz no hereda ningún método.

URLSearchParams.append()

Agrega el par de llave/valor especificado como un nuevo parámetro de búsqueda.

URLSearchParams.delete()

Elimina el parámetro de búsqueda especificado, y su valor asociado, de la lista de todos los parámetros de búsqueda.

URLSearchParams.entries()

Returna un iterator que permite iterar a traves de todos los pares de llave/valor que contiene el objeto.

URLSearchParams.get()

Returna el primer valor asociado al parámetro de búsqueda especificado.

URLSearchParams.getAll()

Returna todas los valores asociados con el parámetro de búsqueda especificado.

URLSearchParams.has()

Returna un Boolean que indica si el parametro de búsqueda especificado existe.

URLSearchParams.keys()

Returna un iterator que permite iterar a través de todas las llaves de los pares de llave/valor que contiene un objeto.

URLSearchParams.set()

Establece el valor al parámetro de búsqueda asociado con el valor dado. Si hay varios valores, elimina los demás.

URLSearchParams.sort()

Organiza todos los pares de llave/valor, si existen, por sus llaves.

URLSearchParams.toString()

Returna una cadena de texto que contiene un parámetro de consulta adecuado para utilizar en una URL.

URLSearchParams.values()

Returna un iterator que permite iterar a través de todos los valores de los pares de llave/valor que contiene un objeto.

Ejemplo

js
var paramsString = "q=URLUtils.searchParams&topic=api";
var searchParams = new URLSearchParams(paramsString);

//Itera los parámetros de búsqueda.
for (let p of searchParams) {
  console.log(p);
}

searchParams.has("topic") === true; // true
searchParams.get("topic") === "api"; // true
searchParams.getAll("topic"); // ["api"]
searchParams.get("foo") === null; // true
searchParams.append("topic", "webdev");
searchParams.toString(); // "q=URLUtils.searchParams&topic=api&topic=webdev"
searchParams.set("topic", "More webdev");
searchParams.toString(); // "q=URLUtils.searchParams&topic=More+webdev"
searchParams.delete("topic");
searchParams.toString(); // "q=URLUtils.searchParams"

Especificaciones

Specification
URL Standard
# urlsearchparams

Compatibilidad con navegadores

BCD tables only load in the browser

Vea también