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

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

Especificaciones Estado Comentario
URL
La definición de 'URLSearchParams' en esta especificación.
Living Standard Definición Inicial.

Compatibilidad con navegadores

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Característica Chrome Firefox (Gecko) Internet Explorer Opera Safari
Soporte básico 49 29.0 (29.0) Sin soporte 36 10.1
entries(), keys(), values(), and support of for...of 49 44.0 (44.0) Sin soporte 36 ?
USVString for constructor init object (Yes) 53.0 (53.0) Sin soporte (Yes) ?
Record for constructor init object Sin soporte 54.0 (54.0) Sin soporte ? ?
Característica Android Webview Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Soporte básico 49 49 29.0 (29.0) Sin soporte ? Sin soporte
entries(), keys(), values(), and support of for...of 49 49 44.0 (44.0) Sin soporte ? Sin soporte
USVString for constructor init object (Yes) (Yes) 53.0 (53.0) Sin soporte ? ?
Record for constructor init object ? ? 54.0 (54.0) Sin soporte ? ?

Vea también

Etiquetas y colaboradores del documento

Colaboradores en esta página: aliveghost04
Última actualización por: aliveghost04,