URLSearchParams
===============

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()` (en-US): `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()` (en-US)

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

`URLSearchParams.delete()` (en-US)

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()` (en-US)

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

`URLSearchParams.get()` (en-US)

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

`URLSearchParams.getAll()` (en-US)

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

`URLSearchParams.has()` (en-US)

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

`URLSearchParams.keys()` (en-US)

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()` (en-US)

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

`URLSearchParams.sort()` (en-US)

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

`URLSearchParams.toString()` (en-US)

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

`URLSearchParams.values()` (en-US)

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 with JavaScript enabled. Enable JavaScript to view data.

Vea también
-----------

* Otras interfaces relacionadas con URL: `URL`, `URLUtils`.
* Google Developers: Fácil manipulación de una URL con URLSearchParams