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.

* Some parts of this feature may have varying levels of support.

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

Compatibilidad con navegadores

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
URLSearchParams
[Symbol.iterator]
URLSearchParams() constructor
USVString for init object
record for init object
sequence for init object
append
delete
value parameter
entries
forEach
get
getAll
has
value parameter
keys
set
size
sort
toString
values

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
No support
No support
See implementation notes.
Has more compatibility info.

Vea también